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/convert-workflow.md
View on GitHub# Format Conversion Workflow
---
TOKEN_BUDGET: 250
TIER: 2
LOAD_TRIGGER: Intent = CONVERT
DEPENDENCIES: SKILL.md
---
## Overview
Convert documentation between Markdown, DOCX, and PDF formats.
## Workflow Steps
### Step 1: Identify Formats
| Request | Source | Target | Skill |
|---------|--------|--------|-------|
| "Convert to Word" | MD | DOCX | docx |
| "Generate PDF" | MD | PDF | pdf |
| "Convert to markdown" | DOCX | MD | docx |
| "PDF package" | Multiple | PDF | pdf |
### Step 2: Validate Source
For Markdown → DOCX/PDF:
- Check heading hierarchy (H1 → H2 → H3)
- Verify internal links
- Ensure tables are well-formed
### Step 3: Invoke Skill
**Markdown → DOCX**:
```
Skill: docx
Source: [file path]
Styling: Professional template
- TOC, heading styles, page numbers
```
**Markdown → PDF**:
```
Skill: pdf
Source: [file path]
Options: Page size, margins, syntax highlighting
```
**Multi-Document PDF**:
```
Skill: pdf
Sources: docs/**/*.md
Options: Combined PDF with bookmarks, cover page
```
### Step 4: Verify & Present Options
After conversion, present options to user:
```
Converted [source] to [target]: [output path]
Options:
1. Generate additional formats
2. Convert other documents
3. Create complete documentation package
```
## Quick Reference
| Task | Skill |
|------|-------|
| MD → DOCX | docx |
| MD → PDF | pdf |
| DOCX → MD | docx |
| Multi-doc PDF | pdf |
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 |