docs-applying-diataxis-framework

What problem does it solve?

Users often struggle to categorize technical documentation consistently, leading to disorganized content that is difficult for readers to navigate and fails to meet the specific needs of different user intents.

Core Features & Use Cases

This Skill defines the four Diátaxis documentation categories (tutorials, how-to guides, reference, and explanation) with clear characteristics, directory mappings, a quick decision matrix, common categorization mistakes to avoid, and content guidelines for each type. For example, a team building an open source repository can use this Skill to structure their docs/ directory so users can easily find learning materials, task-specific guides, technical specifications, and conceptual explanations without confusion.

Quick Start

Use the docs-applying-diataxis-framework skill to categorize your new project documentation into the correct Diátaxis type and place it in the appropriate docs/ subdirectory.