What are the four quadrants of Diátaxis?

The four quadrants are Tutorials (learning-oriented), How-to Guides (task-oriented), Reference (information-oriented), and Explanation (understanding-oriented).

What is the Diátaxis framework?

Diátaxis is a systematic approach to technical documentation that categorizes content into four distinct types: tutorials, how-to guides, reference, and explanation, each serving a different user need.

Can I use this for existing documentation?

Yes, this skill can be used to audit and refactor existing documentation, helping you separate explanations from tutorials or reference material from how-to guides for better clarity.

Why should I avoid mixing documentation types?

Mixing types confuses the reader's intent. For example, adding deep conceptual explanations into a quick how-to guide slows down the practitioner who just needs to solve a specific problem.

How does this skill help with documentation?

It provides domain-specific guidance and patterns to ensure your documentation is correctly structured for its intended audience, helping you avoid confusing 'mixed' documentation types.

Diátaxis Documentation Expert

Name: Diátaxis Documentation Expert
Author: wsagency

bywsagency

0•

学習とドキュメンテーション

Implements the Diátaxis framework to structure and write high-quality technical documentation across four distinct quadrants.

This skill equips Claude with specialized knowledge of the Diátaxis framework, a systematic approach to technical documentation that organizes content based on user needs. It helps users differentiate between tutorials, how-to guides, reference material, and explanations, ensuring each piece of content serves a specific intent without overlapping. By applying these architectural principles, the skill assists developers in creating clear, navigable, and purposeful documentation that improves user onboarding and enhances system understanding.

主な機能

010 GitHub stars

02User-centric documentation structuring based on specific intent and orientation

03Quadrant-based content classification for tutorials, how-to guides, reference, and explanation

04Concise, task-oriented writing for practical and efficient how-to guides

05Step-by-step tutorial creation focused on beginner confidence and competence

06Identification and correction of common documentation anti-patterns and mixed types

ユースケース

01Drafting technical reference materials that focus strictly on accurate system information

02Refactoring existing mixed-content docs into clear, distinct functional categories

03Structuring a new software project's documentation site from the ground up

主な機能

010 GitHub stars

02User-centric documentation structuring based on specific intent and orientation

03Quadrant-based content classification for tutorials, how-to guides, reference, and explanation

04Concise, task-oriented writing for practical and efficient how-to guides

05Step-by-step tutorial creation focused on beginner confidence and competence

06Identification and correction of common documentation anti-patterns and mixed types

ユースケース

01Drafting technical reference materials that focus strictly on accurate system information

02Refactoring existing mixed-content docs into clear, distinct functional categories

03Structuring a new software project's documentation site from the ground up