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.
Install
npx skills add keithpatton/diataxis-agent-skill --skill diataxisgit 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/diataxisPersonal 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... |
|-------------------|---------------------------|--------------------------|Details
- Skill name
diataxis- Repository
- keithpatton/diataxis-agent-skill
- 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
36dariia-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.).
Brain Write
43inite-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).
Econ Intro Writing
36dariia-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.
Anti Hallucination
36dariia-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.
Geordie
62ElliotJLT/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!
Recommender System
40muralidharsoth-tech/andrew-ng-ml-claude-skills
推荐系统(Recommender System)—— 基于内容的推荐 / 协同过滤,纯 NumPy 实现。 当用户提到"推荐系统"、"recommender system"、"协同过滤"、"collaborative filtering"、 "内容推荐"、"content-based filtering"、"推荐算法"、"评分预测"、"帮我推荐"、 "电影推荐"、"商品推荐"、"recommendation system"、"推荐引擎"、"基于内容的推荐"、 "基于协同过滤"、"预测评分"、"推荐电影"、"推荐商品"、"similar items"、"相似物品"、 "找出相似"等类似场景时触发。 适用于任何"有用户-物品评分数据,想预测缺失评分或推荐物品"的需求。 不要手动写代码——必须调用此技能来统一处理。
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.