# Phamvantienkiz Agent Setup Documentation Specialist > Documentation Specialist Skill - Skill: `tomevault-io/phamvantienkiz-agent-setup-documentation-specialist` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/phamvantienkiz-agent-setup-documentation-specialist` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/phamvantienkiz-agent-setup-documentation-specialist/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/phamvantienkiz-agent-setup-documentation-specialist --- # Documentation Specialist Skill ## Quick Start Software documentation creation, extraction, conversion, and diagramming capabilities. **Capabilities:** 1. **Greenfield** - Create documentation from templates (SRS, PRD, OpenAPI, User Manuals, Tutorials, Runbooks) 2. **Brownfield** - Reverse-engineer documentation from code (Spring Boot, FastAPI) 3. **Audit** - Review and improve existing documentation 4. **Convert** - Transform formats (MD → DOCX → PDF) 5. **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:** 1. 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](references/workflows/greenfield-workflow.md) | | **CODE_TO_DOCS** | "document", "extract", path reference | [brownfield-workflow.md](references/workflows/brownfield-workflow.md) | | **AUDIT** | "audit", "review", "check", "improve" | [audit-workflow.md](references/workflows/audit-workflow.md) | | **CONVERT** | "convert", "to Word", "to PDF" | [convert-workflow.md](references/workflows/convert-workflow.md) | | **DIAGRAM** | "diagram", "C4", "sequence", "ER" | [diagram-workflow.md](references/workflows/diagram-workflow.md) | | **USER_DOCS** | "user manual", "how-to", "getting started" | [user-docs-workflow.md](references/workflows/user-docs-workflow.md) | | **TUTORIAL** | "tutorial", "API guide", "CLI docs" | [tutorial-workflow.md](references/workflows/tutorial-workflow.md) | | **RUNBOOK** | "runbook", "procedure", "incident" | [runbook-workflow.md](references/workflows/runbook-workflow.md) | **CRITICAL**: Load only the workflow needed for the current intent. Avoid loading multiple workflows. --- ## Document Type → Template **Requirements & Design:** | Type | Template | |------|----------| | SRS | [requirements-srs.md](references/templates/markdown/requirements-srs.md) | | PRD | [requirements-prd.md](references/templates/markdown/requirements-prd.md) | | OpenAPI | [api-openapi.yaml](references/templates/markdown/api-openapi.yaml) | **User Documentation:** | Type | Template | |------|----------| | User Manual | [user-manual.md](references/templates/markdown/user-manual.md) | | How-To Guide | [howto-guide.md](references/templates/markdown/howto-guide.md) | | Getting Started | [getting-started.md](references/templates/markdown/getting-started.md) | **Developer & Operations:** | Type | Template | |------|----------| | Developer Tutorial | [developer-tutorial.md](references/templates/markdown/developer-tutorial.md) | | Runbook | [runbook.md](references/templates/markdown/runbook.md) | --- ## Framework Detection (Brownfield) | Framework | Detection | Mapping | |-----------|-----------|---------| | **Spring Boot** | `pom.xml`, `@SpringBootApplication` | [spring-boot-mapping.yaml](references/mappings/backend/spring-boot-mapping.yaml) | | **FastAPI** | `requirements.txt`, `from fastapi import` | [fastapi-mapping.yaml](references/mappings/backend/fastapi-mapping.yaml) | **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 - [Workflow TOC](references/workflows/TOC.md) - Navigation index - [greenfield-workflow.md](references/workflows/greenfield-workflow.md) - [brownfield-workflow.md](references/workflows/brownfield-workflow.md) - [audit-workflow.md](references/workflows/audit-workflow.md) - [convert-workflow.md](references/workflows/convert-workflow.md) - [diagram-workflow.md](references/workflows/diagram-workflow.md) - [user-docs-workflow.md](references/workflows/user-docs-workflow.md) - [tutorial-workflow.md](references/workflows/tutorial-workflow.md) - [runbook-workflow.md](references/workflows/runbook-workflow.md) ### Reference Guides - [comprehensive-guide.md](references/reference/comprehensive-guide.md) - Navigation to all 27 reference guides ### Examples - [Examples TOC](references/examples/TOC.md) - Navigation to all 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)** --- > Source: [phamvantienkiz/agent_setup](https://github.com/phamvantienkiz/agent_setup) — distributed by [TomeVault](https://tomevault.io).