diataxis-documentation

Classify technical documentation into Diataxis framework categories.

121|10|Updated Mar 17, 2026

Search Tags:#documentation #reference #how-to #explanation #tutorial #diataxis

Ready to run

npx skills add https://github.com/sortie-ai/sortie --skill diataxis-documentation-sortie-ai

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: diataxis-documentation
Source: https://github.com/sortie-ai/sortie/tree/main/.github/skills/diataxis-documentation
Command: npx skills add https://github.com/sortie-ai/sortie --skill diataxis-documentation-sortie-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diataxis documentation helps technical writers and teams structure content by type and purpose, ensuring readers can locate the exact kind of information they need (tutorials, how-to guides, references, or explanations) and apply a consistent quality standard across the product.

Core Features & Use Cases

Classify content into Tutorials, How-to Guides, Reference, or Explanation and route it to the appropriate structure.
Maintain cross-links and a consistent voice, style, and boundary discipline as content evolves.
Audit existing documentation for type purity and structural correctness.

Quick Start

Classify a document with the Diataxis compass and generate a clean, type-pure documentation artifact.

Frequently Asked Questions about diataxis-documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What is the Diataxis framework for structuring technical documentation?▼

Technical documentation is classified into Tutorials, How-to Guides, Reference, and Explanation categories by the Diataxis framework to align content with reader intent. This ensures readers locate the exact information type they need.

How do I audit existing product documentation for structural correctness?▼

Auditing existing product documentation involves classifying content against the Diataxis framework to check for type purity and structural correctness. This process evaluates boundaries, tone, and cross-links to maintain accuracy and consistency.

When should I separate tutorials from how-to guides in technical writing?▼

Tutorials and how-to guides should be separated when structuring technical documentation to maintain type purity. Tutorials focus on learning and motivation, while how-to guides provide direct steps to accomplish specific tasks.

Does the Diataxis framework work for onboarding materials and product docs?▼

Yes, the Diataxis framework applies to writing, reviewing, and auditing product documentation and onboarding materials. It classifies content to apply a consistent voice, style, and boundary discipline as materials evolve.

What is the best way to maintain cross-links and consistent voice across documentation?▼

Maintaining cross-links and a consistent voice across documentation is best achieved by applying the Diataxis framework to enforce boundary discipline. This ensures accuracy and consistency as content evolves over time.