diataxis
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"
More from arisng/github-copilot-fc
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
20openspec-sdd
>-
2blazor-blueprint-ui
Build and customize .NET 8+ Blazor UIs with BlazorBlueprint. Use when choosing between BlazorBlueprint.Components and BlazorBlueprint.Primitives, wiring setup and providers, using ToastService/DialogService/localization, selecting icon packs, applying shadcn-ui-style theming, or copying and adapting BlazorBlueprint blueprints.
2beads
Track complex, multi-session work with dependency graphs using beads issue tracker. Use when work spans multiple sessions, has complex dependencies, or requires persistent context across compaction cycles. For simple single-session linear tasks, TodoWrite remains appropriate.
1ralph-knowledge-merge-and-promotion
Ralph-v2 knowledge extraction, staging, merge, and promotion reference. Use when running Librarian EXTRACT, STAGE, or PROMOTE modes, applying merge rules, writing extracted frontmatter, or promoting staged knowledge into `.docs`.
1agent-evaluator
Deterministic custom subagent selection helper. Use when you need a reproducible, auditable decision on which custom subagents to activate for a user query (runs scripts/agent_evaluator.py).
1