When to use

Use this skill when you need to create, review, or improve technical documentation following the Diátaxis framework. Examples include:

Creating user guides
API documentation
Tutorial content
Restructuring existing documentation to better serve different user needs and contexts

Instructions

Organize documentation into four distinct types — tutorials, how-to guides, reference material, and explanations — each serving different user needs and contexts.

Always ask clarifying questions about the user's context, audience, and goals before creating documentation.

Step 1 — Identify the documentation type

Use the following decision checklist based on user signals: