Diataxis

Classify, validate, generate, and audit documentation using the Diátaxis framework. Enforces quadrant purity across tutorials, how-to guides, reference, and explanation. Use when creating documentation, reviewing docs, auditing doc sets, restructuring existing content, or when the user mentions Diátaxis, documentation structure, or doc quality.

23 stars 3 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add keithpatton/diataxis-agent-skill --skill diataxis
Manual install
git clone --depth 1 https://github.com/keithpatton/diataxis-agent-skill.git /tmp/diataxis-agent-skill
mkdir -p ~/.claude/skills
cp -r /tmp/diataxis-agent-skill/diataxis ~/.claude/skills/diataxis

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Diátaxis Documentation Governance

This skill enforces the Diátaxis framework for documentation. Diátaxis identifies four distinct documentation types based on user needs: **tutorials**, **how-to guides**, **reference**, and **explanation**. Each serves a different purpose and must be written differently.

## Operating Modes

This skill operates in one of the following modes:

- **classify**: Identify which quadrant content belongs to
- **audit**: Analyze a doc set for gaps, imbalances, and violations
- **generate**: Create new documentation in a specified quadrant
- **restructure**: Split or reorganize existing mixed-mode content

The mode must be inferred from the user request or explicitly stated. If the operating mode cannot be confidently inferred, ask for clarification before proceeding.

Refusal with explanation is a valid and successful outcome when quadrant purity cannot be maintained.

### Generate Mode Policy

For generate mode, one of the following must be true before producing content:

- The user explicitly states the target quadrant ("write a How-to for X"), OR
- The agent classifies the request, presents reasoning with confidence+evidence, and receives user confirmation

## The Diátaxis Compass

Use this decision tree to classify content into exactly ONE quadrant:

| If content...     | ...and serves user's...   | ...then it belongs to... |
|-------------------|---------------------------|--------------------------|
Read the full skill on GitHub

Details

Skill name
diataxis
Path
diataxis/SKILL.md
License
CC-BY-SA-4.0
Repo updated
27 January 2026

FAQ

What does the Diataxis skill do?

Classify, validate, generate, and audit documentation using the Diátaxis framework. Enforces quadrant purity across tutorials, how-to guides, reference, and explanation. Use when creating documentation, reviewing docs, auditing doc sets, restructuring existing content, or when the user mentions Diátaxis, documentation structure, or doc quality.

How do I install the Diataxis skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add keithpatton/diataxis-agent-skill --skill diataxis. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Diataxis popular?

It lives in keithpatton/diataxis-agent-skill, which has 23 GitHub stars and 3 forks.

Related skills

Econ Abstract Writing

36

dariia-m/my_claude_skills

Guide for writing the abstract of an academic economics paper. Use this skill whenever the user asks for help writing, drafting, revising, or structuring an abstract for an economics paper - whether empirical micro, development economics, applied economics, or related fields. Also trigger when the user mentions "abstract," "paper summary," or asks how to compress their findings into a short description. This skill synthesizes best practices from David Evans (CGDev), Marc Bellemare, and patterns observed in top economics journals (AER, QJE, AEJ: Applied, etc.).

Writing & Content11

Brain Write

43

inite-ai/inite-brain-service

How to write to the INITE Brain knowledge graph from an agent loop — record_fact (with the conversationId / evidence[] grounding inputs), ingest_document, link_entities, retract_fact, record_feedback, and the detect_contradiction preflight. Covers confidence picking, claim grounding, retract vs forget semantics, identity_of cycle-guards. Use when the user explicitly wants to record, merge, or revise structured knowledge from a conversation (not when they're just asking a question).

Writing & Content

Econ Intro Writing

36

dariia-m/my_claude_skills

Guide for writing the introduction to an academic economics paper. Use this skill whenever the user asks for help writing, drafting, revising, or structuring an introduction to an economics paper - whether empirical micro, development economics, applied economics, or related fields. Also trigger when the user mentions "intro," "introduction section," "opening paragraphs," or asks how to motivate, frame, or present their research question in a paper. This skill synthesizes best practices from David Evans (CGDev), Keith Head, Claudia Sahm, Marc Bellemare, and Deirdre McCloskey.

Writing & Content11

Anti Hallucination

36

dariia-m/my_claude_skills

ALWAYS activate this skill. Apply these rules to every task regardless of domain. This skill governs how Claude Code verifies information, writes code, references documentation, and avoids fabricating functions, arguments, APIs, file paths, data structures, or facts. These rules override any inclination to guess.

Writing & Content11

Geordie

62

ElliotJLT/Claude-Skill-Potions

When activated, respond entirely in Geordie dialect from Newcastle upon Tyne. Use proper Geordie words, phrases, and grammar. Reference Newcastle United players, legends, and lore when making analogies or celebrating wins. Channel the spirit of St James' Park, The Entertainers, and Wor Jackie himself. Howay the lads!

Writing & Content

Recommender System

40

muralidharsoth-tech/andrew-ng-ml-claude-skills

推荐系统(Recommender System)—— 基于内容的推荐 / 协同过滤,纯 NumPy 实现。 当用户提到"推荐系统"、"recommender system"、"协同过滤"、"collaborative filtering"、 "内容推荐"、"content-based filtering"、"推荐算法"、"评分预测"、"帮我推荐"、 "电影推荐"、"商品推荐"、"recommendation system"、"推荐引擎"、"基于内容的推荐"、 "基于协同过滤"、"预测评分"、"推荐电影"、"推荐商品"、"similar items"、"相似物品"、 "找出相似"等类似场景时触发。 适用于任何"有用户-物品评分数据,想预测缺失评分或推荐物品"的需求。 不要手动写代码——必须调用此技能来统一处理。

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.