← ClaudeAtlas

diataxis-createlisted

Create new documentation following the Diátaxis framework. Use when writing documentation from scratch, when a user requests a tutorial, how-to guide, reference, or explanation document, or when filling documentation gaps.
jrjsmrtn/diataxis-skills · ★ 1 · Data & Documents · score 75
Install: claude install-skill jrjsmrtn/diataxis-skills
# Diátaxis Documentation Creator Create new documentation in the correct [Diátaxis](https://diataxis.fr/) quadrant using structured templates. ## Diátaxis Compass ``` Practical Theoretical +----------------+------------------+ Study | TUTORIALS | EXPLANATION | | (learning) | (understanding) | +----------------+------------------+ Work | HOW-TO | REFERENCE | | (problem) | (information) | +----------------+------------------+ ``` ## When to Use - Writing documentation from scratch for a new project or feature - User requests a specific type of documentation - Filling gaps identified by a `diataxis-audit` - Adding a new document to an existing documentation set ## Required Inputs 1. **Topic**: What the documentation is about 2. **Quadrant** (optional): If the user specifies tutorial/how-to/reference/explanation. If not specified, classify the request: - "Show me how to get started" → Tutorial - "How do I configure X?" → How-to guide - "What are all the options for Y?" → Reference - "Why does Z work this way?" → Explanation 3. **Target audience** (optional): Experience level and context 4. **Output path** (optional): Where to write the document ## Recommended Creation Order When building documentation from scratch for a project, follow this order: 1. **Tutorial** — fastest value for new users, validates the system works, reveals UX issues 2. **Reference**