| name | documentation-specialist |
| description | This skill should be used when creating professional software documentation (SRS, PRD, OpenAPI,
user manuals, tutorials, runbooks) from templates (greenfield) or reverse-engineering documentation
from existing code like Spring Boot or FastAPI (brownfield). Also handles documentation audits/reviews,
format conversion (Markdown, DOCX, PDF), and diagram generation (C4, Mermaid, PlantUML, ER, sequence).
Use when asked to "create documentation", "document my code", "write SRS", "generate PRD", or "documentation specialist".
|
| version | 3.0-PDA |
| allowed-tools | ["Read","Write","Edit","Glob","Grep","Bash","Skill"] |
Documentation Specialist Skill
Quick Start
Software documentation creation, extraction, conversion, and diagramming capabilities.
Capabilities:
- Greenfield - Create documentation from templates (SRS, PRD, OpenAPI, User Manuals, Tutorials, Runbooks)
- Brownfield - Reverse-engineer documentation from code (Spring Boot, FastAPI)
- Audit - Review and improve existing documentation
- Convert - Transform formats (MD → DOCX → PDF)
- Diagram - Generate visuals (Mermaid C4, PlantUML UML)
Example Requests:
Create an SRS for a billing system with PCI-DSS compliance
Document my Spring Boot application at ~/projects/customer-api
Create a user manual for my SaaS product
Write a database failover runbook
Audit my API documentation at docs/api/openapi.yaml
Convert docs/srs.md to Word format
Create a C4 container diagram for my microservices
Execution Flow:
- Classify intent → 2. Load workflow → 3. Execute steps → 4. Generate documentation → 5. Present post-processing options
Intent Classification
| Intent | Keywords | Workflow |
|---|
| CREATE_NEW | "create", "generate", "write" + doc type | greenfield-workflow.md |
| CODE_TO_DOCS | "document", "extract", path reference | brownfield-workflow.md |
| AUDIT | "audit", "review", "check", "improve" | audit-workflow.md |
| CONVERT | "convert", "to Word", "to PDF" | convert-workflow.md |
| DIAGRAM | "diagram", "C4", "sequence", "ER" | diagram-workflow.md |
| USER_DOCS | "user manual", "how-to", "getting started" | user-docs-workflow.md |
| TUTORIAL | "tutorial", "API guide", "CLI docs" | tutorial-workflow.md |
| RUNBOOK | "runbook", "procedure", "incident" | runbook-workflow.md |
CRITICAL: Load only the workflow needed for the current intent. Avoid loading multiple workflows.
Document Type → Template
Requirements & Design:
User Documentation:
Developer & Operations:
Framework Detection (Brownfield)
Process: Glob for detection files → Grep for patterns → Load mapping → Follow brownfield workflow
On-Demand Resources
Load only what is needed for the current task.
Workflows
Reference Guides
Examples
Skill Integration
| Skill | Invocation Trigger |
|---|
| docx | Request includes Word format |
| pdf | Request includes PDF format |
| plantuml | UML diagrams (ER, sequence, component) |
| mermaid-architect | C4 diagrams, flowcharts |
Error Handling
| Error | Response |
|---|
| Cannot detect framework | Ask: "Is this Spring Boot, FastAPI, or another framework?" |
| Missing template | Use closest match, inform user |
| Skill not available | Offer markdown-only alternative |
| Ambiguous request | Ask: "Would you prefer SRS (formal) or PRD (agile)?" |
Antigravity Integration
This skill is compatible with Antigravity IDE. When running in Antigravity, use the following adaptations.
Tool Mapping
| Claude Code Tool | Antigravity Equivalent | Usage |
|---|
Read | view_file, view_file_outline | Read skill files, templates, references |
Write | write_to_file | Create new documentation files |
Edit | replace_file_content, multi_replace_file_content | Edit existing docs |
Glob | find_by_name | Search for files by pattern |
Grep | grep_search | Search content within files |
Bash | run_command | Execute shell commands |
Skill | view_file (read another skill's SKILL.md) | Chain to other skills |
Path Resolution
In Antigravity, resolve all relative paths from the skill base directory:
~/.gemini/antigravity/skills/document-specialist/
Example: references/templates/markdown/requirements-srs.md resolves to:
~/.gemini/antigravity/skills/document-specialist/references/templates/markdown/requirements-srs.md
For sub-workflow cross-references (e.g., greenfield/srs-guide.md inside greenfield-workflow.md), resolve relative to the referencing file's directory, not the skill root.
Fallback Behavior (Missing Skills)
| Requested Feature | Missing Skill | Fallback |
|---|
| Export to Word (DOCX) | docx | Inform user DOCX not available; offer Markdown output |
| Export to PDF | pdf | Inform user PDF not available; offer Markdown output |
| PlantUML diagrams (ER, sequence) | plantuml | Generate Mermaid syntax inline (Antigravity supports Mermaid rendering) |
| C4 diagrams, flowcharts | mermaid-architect | Generate Mermaid syntax inline directly |
End of SKILL.md (v3.0-PDA, Antigravity-adapted)
