diataxis-documentation-guidance

Installation
SKILL.md

Diataxis Documentation Guidance

Use this skill to help documentation contributors and maintainers produce mode-correct, actionable docs as defined by https://diataxis.fr/.

Routing

Pick the entry point by user intent:

  • Classification or mode selection requests: read references/decision-flow.md
  • Drafting or rewriting requests: read references/drafting-guide.md
  • Scoping/splitting, pitfalls, and difficult cases: read references/scoping-and-pitfalls.md
  • Concrete examples for each mode: read references/examples.md

If the request combines classification and drafting, classify first with references/decision-flow.md, then draft with references/drafting-guide.md.

Output Contract

For classification-only responses, return exactly four labeled parts:

Related skills

More from robdefeo/agent-skills

Installs
9
GitHub Stars
3
First Seen
Mar 6, 2026