Agent skill · writing content · aiskillstore
human-docs
Creates human-friendly documentation from AI context documentation. Transforms detailed AI documentation in ai/ folder into digestible summaries, quick starts, and visual diagrams in docs/ folder. Use when users need to quickly understand complex systems or when AI documentation is too detailed for human consumption. Specializes in Mermaid diagrams, executive summaries, and quick reference guides.
Why this skill is useful
Adds specific workflows and templates for creating human-friendly documentation from AI context docs, which the AI wouldn't reliably generate on its own.
What it needs
About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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 Key rule: docs/ mirrors ai/ structure but contains human-optimized versions 2. Three Human-Friendly Formats For each AI doc, create ONE or MORE of: 1. SUMMARY (SUMMARY.md) Executive summary (1-2 paragraphs) Key points (bullet list) Quick decision aids 20% of original length 2. QUICKSTART (QUICKSTART.md) Step-by-step getting started 5-minute read maximum Code examples Common pitfalls Success criteria 3. DIAGRAMS (DIAGRAMS.md) Visual representation with Mermaid.js Architecture diagrams Flow charts Sequence diagrams Entity relationships 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/human-docs