# Documentation Generator

> Generate documentation for migrated systems including API docs, architecture docs, and runbooks

- Skill: `a5c-ai/documentation-generator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add a5c-ai/documentation-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/a5c-ai/documentation-generator/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: a5c-ai (https://skillmd.com/u/a5c-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/a5c-ai/documentation-generator

---


# Documentation Generator Skill

Generates comprehensive documentation for migrated systems including API documentation, architecture diagrams, and operational runbooks.

## Purpose

Enable documentation creation for:
- API documentation generation
- Architecture documentation
- Runbook generation
- Change documentation
- Diagram generation

## Capabilities

### 1. API Documentation Generation
- Generate from OpenAPI specs
- Create interactive docs
- Include examples
- Support versioning

### 2. Architecture Documentation
- Create architecture diagrams
- Document components
- Map dependencies
- Explain patterns

### 3. Runbook Generation
- Create operational procedures
- Document troubleshooting
- Include escalation paths
- Generate playbooks

### 4. Change Documentation
- Document migration changes
- Track before/after
- Note breaking changes
- Generate release notes

### 5. Migration Guide Creation
- Create upgrade guides
- Document migration steps
- Include rollback procedures
- Provide checklists

### 6. Diagram Generation
- Generate architecture diagrams
- Create sequence diagrams
- Build data flow diagrams
- Produce deployment diagrams

## Tool Integrations

| Tool | Purpose | Integration Method |
|------|---------|-------------------|
| Swagger UI | API docs | CLI |
| AsyncAPI | Event docs | CLI |
| PlantUML | Diagrams | CLI |
| Mermaid | Diagrams | Markdown |
| Backstage | Developer portal | Config |
| MkDocs | Documentation site | CLI |

## Output Schema

```json
{
  "generationId": "string",
  "timestamp": "ISO8601",
  "documentation": {
    "api": {
      "path": "string",
      "format": "string"
    },
    "architecture": {
      "path": "string",
      "diagrams": []
    },
    "runbooks": [],
    "guides": []
  },
  "artifacts": {
    "site": "string",
    "pdfs": [],
    "diagrams": []
  }
}
```

## Integration with Migration Processes

- **documentation-migration**: Primary doc generation
- All migration processes (change documentation)

## Related Skills

- `openapi-generator`: API spec generation
- `knowledge-extractor`: Source material

## Related Agents

- `documentation-migration-agent`: Doc orchestration
- `operational-readiness-agent`: Runbook creation