diataxis
SKILL.md
Diátaxis Documentation Skill
The Diátaxis framework organizes documentation by user need, not by topic. This skill helps you create documentation that works for your audience.
The Four Categories
Diátaxis distinguishes four documentation needs using a 2×2 matrix:
| Practical | Theoretical | |
|---|---|---|
| Learning | Tutorials | Explanation |
| Working | How-to Guides | Reference |
Quick Reference
- Tutorials (Learning + Practical): "Teach me by doing"
- How-to Guides (Working + Practical): "Help me accomplish X"
- Reference (Working + Theoretical): "Tell me how things work"
- Explanation (Learning + Theoretical): "Help me understand why"