diataxis-organize-docs
Installation
SKILL.md
Diataxis Documentation Organization
Reorganize documentation by classifying content into the four Diataxis quadrants and creating a structured documentation hierarchy.
The Four Quadrants
| Quadrant | Orientation | Purpose | User Need |
|---|---|---|---|
| Tutorial | Learning | Teach through doing | "I want to learn" |
| How-to | Task | Solve specific problems | "I want to accomplish X" |
| Reference | Information | Describe the machinery | "I need facts about Y" |
| Explanation | Understanding | Clarify concepts | "I want to understand why" |
Step 1: Analyze Existing Documentation
Scan the documentation directory and classify each file or section:
For each document/section, determine:
Related skills
More from trogonstack/agentskills
datadog-design-dashboard
>-
36diataxis-gen-readme
Generate a README introduction following the Diataxis 4-paragraph structure for product documentation.
31nats-design-subject
>-
30gh-enrich-pr-description
Enrich GitHub PR descriptions with root-cause context, related issues/PRs, and CC mentions. Use when creating or editing a PR, when a PR has an empty or sparse description, or when the user asks to improve a PR description.
26ask-question
>-
23otel-name-span
>-
21