diataxis
Installation
SKILL.md
Diátaxis
1. Scope
CLASSIFY create | revise | audit | restructure. RECORD product/craft, practitioner+competence, immediate situation, outcome, bounded pages/dir/journey. INSPECT live product/commands/API/config/examples + repo doc conventions; product behavior wins.
2. Compass
| need | context | form |
|---|---|---|
| action | acquisition | tutorial |
| action | application | how-to |
| cognition | application | reference |
| cognition | acquisition | explanation |
Classify by served need, not title/difficulty/length/steps. One dominant need per coherent page/section; brief support allowed only if flow remains. Distinct sustained need => split+link.