diataxis-documentation

What problem does it solve?

This skill helps teams produce clear, user-focused documentation by systematically classifying content into the four Diataxis types and guiding iterative improvements, preventing blur between tutorials, how-tos, references, and explanations.

Core Features & Use Cases

• Type separation guidance for Tutorials, How-to Guides, Reference, and Explanations
• Iterative improvement framework (Choose → Assess → Decide → Do) to refine content in small steps
• Cross-referencing recommendations to connect related types without merging their purposes
• Real-world use: reorganize an existing project wiki or README into purposeful Diataxis sections for better usability

Quick Start

Begin by selecting an existing document, identify the user need, assign a Diataxis type, and outline a minimal improvement.