iw-tech-doc-writerlisted
Install: claude install-skill innovation-ways/iw-ai-core
# Innovation Ways Technical Document Writer
## Purpose
Generate publication-ready technical documents with embedded Mermaid diagrams, code examples, tables, and callout boxes. Output includes branded HTML and PDF. Documents follow the C4 model for architecture diagrams and use progressive detail levels.
## Prerequisites
Before writing, load these dependencies:
1. **Brand configuration**: Read `templates/brand/brand.json` for colors, fonts, and diagram theme
2. **Tone of voice**: Read `templates/brand/tone-of-voice.md` — use the "Documentation Voice" section
3. **Document structure reference**: Read `skills/iw-tech-doc-writer/references/doc-structure-{type}.md` for the selected document type
4. **Diagram guidelines**: Read `skills/iw-tech-doc-writer/references/diagram-guidelines.md` for diagram requirements per document type
5. **Research guide**: For detailed best practices, consult `docs/research/R-00065-tech-doc-visual-design.md`
## Instructions
### 1. Determine Document Type
Select based on the `--type` flag or infer from the request:
| Type | When to Use | Typical Length | Min Diagrams |
|------|-------------|----------------|--------------|
| **architecture** | System design, component relationships, data flows | 3,000-8,000 words | 5-8 |
| **infrastructure** | Deployment topology, networking, environments, ops procedures | 2,000-5,000 words | 3-5 |
| **api** | Endpoint reference, authentication, error handling, examples | 2,000-6,000 words | 2-4 |
| **user-guid