What problem does it solve? Technical documentation often mixes tutorials, how-to guides, reference material, and explanations into confusing pages that fail to serve any reader well. This Skill applies the Diataxis framework to classify content by user need, enforce clean boundaries between document types, and iteratively improve existing documentation. ## Core Features & Use Cases - Document Type Classification: Uses the Diataxis compass (Action vs Cognition, Acquisition vs Application) to determine whether content should be a Tutorial, How-to Guide, Reference, or Explanation. - Authoring Guidance: Provides type-specific principles, structure templates, and language patterns for writing each of the four documentation types. - Documentation Review: Runs an iterative audit workflow that challenges each section, identifies boundary violations (e.g., explanations inside tutorials), and applies targeted improvements. - Use Case: When asked to write a getting-started guide for a new API, the Skill identifies it as a Tutorial, structures it as a single reliable learning path with verifiable results, and links out conceptual background to a separate Explanation page. ## Quick Start Ask the assistant to review your documentation page using the Diataxis framework and identify which document type each section should be.
