diataxis

What problem does it solve? Documentation often mixes tutorials, how-to guides, reference material, and explanations into a single undifferentiated document, making it hard for readers to learn, accomplish tasks, or look up facts. This Skill separates content into the four Diataxis quadrants and enforces per-quadrant quality criteria. ## Core Features & Use Cases - Quadrant-Specific Writing: Four specialized writer agents produce tutorials, how-to guides, reference docs, and explanations, each following dedicated templates and quality criteria. - Documentation Classification: A classifier agent analyzes requests against the two Diataxis axes (practical/theoretical, acquisition/application) and returns a quadrant assignment with a deterministic confidence score. - Documentation Auditing: An auditor agent detects quadrant mixing, anti-patterns, and voice violations in existing docs, producing structured audit reports with severity-graded findings. - Use Case: Ask for a tutorial on setting up a project; the classifier routes the request, the tutorial writer produces a step-by-step guide with prerequisites and visible results per step, and the auditor verifies it contains no explanation digressions. ## Quick Start Ask the assistant to write a tutorial for setting up your first project, or to audit an existing documentation file for quadrant mixing.