Skill
Documentation Writer (Diátaxis)
Sorts technical docs into tutorial, how-to, reference and explanation.
Install
gh skills install github/awesome-copilot documentation-writer
Triggers on
When product or developer documentation is written or an existing doc set is restructured.
- Author
- github/awesome-copilot contributors
- License
- MIT
Most documentation reads badly because one page tries to teach, instruct and explain at the same time. This skill applies the Diátaxis framework: decide which of the four kinds a page is, then write only that kind, with the tone and structure it calls for. A tutorial is a lesson with a guaranteed outcome, a how-to is a recipe for someone who already knows the terrain, and reference stays descriptive.
Comments(0)
Sign in to comment