writing
Installation
SKILL.md
Route writing tasks to the correct artifact structure. Classify first, then write.
Artifact Types
| Artifact | Key structure |
|---|---|
| Docs (public/internal) | Diataxis: pick one mode per section — tutorial, how-to, reference, or explanation. Never mix. |
| ADR / decisions | See references/decision-template.md; numbered, immutable once accepted |
| Changelog / release notes | User-facing impact grouped by type (added, changed, fixed, removed) |
| README | Purpose → quick start → usage → contributing; scannable, no walls of text |
| Runbook | Trigger → steps → verification → rollback; executable by someone unfamiliar with the system |
Docs Impact
Classify scope before writing: