diataxis

Classify documentation content into Diataxis categories and suggest structures.

1|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/hgflima/loopy --skill diataxis-hgflima
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diataxis
Source: https://github.com/hgflima/loopy/tree/main/.claude/skills/diataxis
Command: npx skills add https://github.com/hgflima/loopy --skill diataxis-hgflima

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you maintain and structure project documentation using the Diataxis method, improving organization and usability.

Core Features & Use Cases

  • Documentation Analysis: Analyze existing documentation, classify pages, and identify gaps.
  • Diataxis Alignment: Classify pages into tutorials, how-to guides, explanations, and references.
  • Documentation Creation: Help create or restructure documentation following Diataxis principles.
  • Use Case: When you need to organize and maintain a project's documentation for better user experience and information access.

Quick Start

Run the diataxis skill in your project directory to start organizing your documentation.

Frequently Asked Questions about diataxis

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

FAQPage Schema
What is the Diataxis method for project documentation?

The Diataxis method structures project documentation by classifying content into four categories: tutorials, how-to guides, explanations, and references. It improves usability by aligning content organization with user needs and information access patterns.

How do I classify existing documentation pages into Diataxis categories?

To classify documentation pages into Diataxis categories, analyze the content's purpose and structure. Identify whether pages act as learning tutorials, practical how-to guides, theoretical explanations, or technical references, then map them accordingly to resolve organizational gaps.

How do I restructure my project documentation using Diataxis principles?

Restructure project documentation using Diataxis principles by running the skill in your project directory. It analyzes existing content, classifies pages into the four Diataxis categories, and suggests a structured layout for better user experience.

Can I use Diataxis to identify gaps in my current documentation structure?

Yes, you can use Diataxis to identify gaps in your documentation structure. By analyzing and classifying existing content into tutorials, how-to guides, explanations, and references, the method highlights missing categories and areas needing creation.

What is the best way to organize software documentation for user experience?

The best way to organize software documentation for user experience is applying the Diataxis method. It separates content into tutorials, how-to guides, explanations, and references, ensuring users find learning materials and technical information efficiently.