Human Documentation Generator

Human Documentation Generator

Purpose

This skill transforms detailed AI documentation stored in ai/ folder into human-friendly documentation in docs/ folder. It creates summaries, quick starts, and visual diagrams that enable humans to quickly understand and operate complex systems.

Key principle: ai/ folder remains the source of truth (detailed, comprehensive, for AI context). docs/ folder contains human-optimized extracts (summaries, diagrams, quick references).

When to Use This Skill

Use this skill when:

• User needs human-readable documentation from AI context docs
• AI documentation is too detailed for quick human consumption
• System complexity requires visual diagrams for understanding
• Need quick start guides or executive summaries
• User specifically mentions difficulty following AI documentation
• Creating onboarding materials for new team members
• Extracting crucial information for operational quick reference

Trigger phrases:

• "Create human docs for..."
• "I can't follow the AI documentation"
• "Make this easier to understand"
• "Create a quick start guide"
• "Add diagrams to explain..."
• "Summarize the AI docs"

Core Principles

1. Parallel Structure Maintained

ai/                          docs/
├── architect/               ├── architect/
│   ├── app/                │   ├── app/
│   │   └── 01_DOC.md       │   │   └── 01_DOC_SUMMARY.md
│   └── src/                │   └── src/
│       └── 01_DOC.md       │       └── 01_DOC_QUICKSTART.md
├── backend/                ├── backend/
├── frontend/               ├── frontend/