Stats
Actions
Tags
From docs-agent
Knowledge about the Diátaxis documentation framework for creating effective technical documentation
How this skill is triggered — by the user, by Claude, or both
Slash command
/docs-agent:diataxisThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill provides comprehensive knowledge about the Diátaxis framework for organizing and writing technical documentation.
This skill provides comprehensive knowledge about the Diátaxis framework for organizing and writing technical documentation.
Diátaxis identifies four distinct documentation types, each serving different user needs:
| Type | Orientation | Purpose | User Need |
|---|---|---|---|
| Tutorials | Learning | Teach through doing | "I want to learn" |
| How-to Guides | Task | Solve specific problems | "I want to accomplish X" |
| Reference | Information | Describe the machinery | "I need to know Y" |
| Explanation | Understanding | Clarify concepts | "I want to understand Z" |
Different users need different quadrants prioritized:
| Audience | Primary Quadrants | Reasoning |
|---|---|---|
| Non-technical users (PMs) | Tutorials, How-to Guides | Covers 80% of needs |
| Developers (API consumers) | Reference, How-to Guides | Need accuracy and recipes |
| New team members (onboarding) | Tutorials, Explanation | Need learning + context |
| Architects/evaluators | Explanation, Reference | Need "why" + "what" |
Diátaxis is used by Cloudflare, Canonical/Ubuntu, Django, Gatsby, and many other major projects. Created by Daniele Procida.
references/ for detailed guidance on each typeexamples/ for templates and examplesnpx claudepluginhub wsagency/ws-claude-marketplace --plugin docs-agentOrganizes project documentation using the Diátaxis framework (tutorials, how-to guides, reference, explanation). Use when auditing, structuring, or restructuring a knowledge base.
Generates Diataxis four-quadrant docs: tutorials (learn-by-doing), how-to guides (tasks), references (facts), explanations (concepts). For creating, auditing, classifying documentation.
Authors technical documentation through a repeatable workflow: audience analysis, Diátaxis-mode selection, structure, draft, review, publish. Covers READMEs, ADRs, API docs, and runbooks.