SpillwaveSolutions/document-specialist-skill / skills/documentation-specialist
documentation-specialist
VerifiedThis skill should be used when creating professional software documentation (SRS, PRD, OpenAPI, SDD, architecture docs, 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 (Mermaid first: C4, sequence, class, ER, state, flowchart; PlantUML Salt for UI wireframes and leftover UML). Use when asked to "create documentation", "document my code", "write SRS", "generate PRD", "write DESIGN_DOC.md", "architecture document", "wireframe", or "documentation specialist".
references/workflows/TOC.md
View on GitHub# Workflow Navigation
Quick reference to find the right workflow for your task.
## Primary Workflows
| Intent | Workflow | Tokens | Description |
|--------|----------|--------|-------------|
| Create new docs | [greenfield-workflow.md](greenfield-workflow.md) | ~350 | Template-based creation |
| Design / SDD / architecture | [design-workflow.md](design-workflow.md) | ~400 | arc42 DESIGN_DOC.md or C4 architecture.md |
| Document code | [brownfield-workflow.md](brownfield-workflow.md) | ~400 | Reverse-engineer from code |
| Review docs | [audit-workflow.md](audit-workflow.md) | ~350 | Audit and improve |
| Change format | [convert-workflow.md](convert-workflow.md) | ~250 | MD to DOCX to PDF |
| Create visuals | [diagram-workflow.md](diagram-workflow.md) | ~350 | Mermaid, PlantUML Salt |
## Specialized Workflows
| Intent | Workflow | Description |
|--------|----------|-------------|
| User documentation | [user-docs-workflow.md](user-docs-workflow.md) | Manuals, how-tos |
| Developer tutorials | [tutorial-workflow.md](tutorial-workflow.md) | API guides, CLI docs |
| Operational docs | [runbook-workflow.md](runbook-workflow.md) | Runbooks, procedures |
## Sub-Guides (Load on demand)
### Greenfield
| Document | Guide | Tokens |
|----------|-------|--------|
| SRS | [greenfield/srs-guide.md](greenfield/srs-guide.md) | ~250 |
| PRD | [greenfield/prd-guide.md](greenfield/prd-guide.md) | ~250 |
| OpenAPI | [greenfield/openapi-guide.md](greenfield/openapi-guide.md) | ~250 |
| Advanced | [greenfield/advanced.md](greenfield/advanced.md) | ~200 |
### Brownfield
| Framework | Guide | Tokens |
|-----------|-------|--------|
| Spring Boot | [brownfield/springboot-guide.md](brownfield/springboot-guide.md) | ~300 |
| FastAPI | [brownfield/fastapi-guide.md](brownfield/fastapi-guide.md) | ~250 |
| Pulumi | [brownfield/pulumi-guide.md](brownfield/pulumi-guide.md) | ~250 |
---
**PDA Principle**: Load only the workflow and sub-guide needed for your current task.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |