该技能将文档视为受控系统：Diátaxis 提供分类法，该技能执行意图，AI 仅在明确范围内工作。

该智能体技能使人工智能智能体能够利用 Diátaxis 框架进行分类、验证、生成和审计文档。在教程、操作指南、参考资料和解释中强制执行象限纯粹性。

这项技能的作用

• 将文档分类为四个Diátaxis象限之一
• 审计关于缺口、不平衡和违规的文档集
• 生成严格遵守象限的新文档
• **将混合模式文档重组为纯象限文档

该技能强制执行单象限纯度：一份文件只承担一个目的。当象限纯度无法维持时，拒绝并解释是有效的结果。

四个象限

Diátaxis Agent Skill

This skill treats documentation as a governed system: Diátaxis provides the taxonomy, this skill enforces intent, and AI operates only within explicit bounds.

An agent skill that enables AI agents to classify, validate, generate, and audit documentation using the Diátaxis framework. Enforces quadrant purity across tutorials, how-to guides, reference, and explanation.

What This Skill Does

• Classify documentation into one of four Diátaxis quadrants
• Audit documentation sets for gaps, imbalances, and violations
• Generate new documentation with strict quadrant adherence
• Restructure mixed-mode documents into pure quadrant documents

The skill enforces single-quadrant purity: one document serves one purpose. When quadrant purity cannot be maintained, refusal with explanation is a valid outcome.

The Four Quadrants

Installation

Option 1: Copy to Your Skills Directory

Clone this repository and copy the diataxis/ folder to your agent’s skills directory:

Cursor

# Project-level
cp -r diataxis/ .cursor/skills/diataxis/

# User-level (global)
cp -r diataxis/ ~/.cursor/skills/diataxis/

Claude Code

# Project-level
cp -r diataxis/ .claude/skills/diataxis/

# User-level (global)
cp -r diataxis/ ~/.claude/skills/diataxis/

Codex

# Project-level
cp -r diataxis/ .codex/skills/diataxis/

# User-level (global)
cp -r diataxis/ ~/.codex/skills/diataxis/

Option 2: Install via skills.sh

npx skills add keithpatton/diataxis-agent-skill

Usage

Once installed, the skill activates when you:

• Ask to create, review, or audit documentation
• Mention Diátaxis, documentation structure, or doc quality
• Request help with tutorials, how-to guides, reference docs, or explanations

Example Prompts

Classification:

“Classify this documentation and tell me which Diátaxis quadrant it belongs to.”

Audit:

“Audit the docs/ folder for Diátaxis compliance and report any violations.”

Generation:

“Write a how-to guide for configuring SSL certificates.”

Restructure:

“This README mixes tutorial and reference content. Split it into separate documents.”

Skill Structure

diataxis/
├── SKILL.md                    # Main skill file (the "constitution")
└── references/
    ├── quadrants.md            # Detailed quadrant characteristics
    ├── compass.md              # Classification decision tree
    └── anti-patterns.md        # Violation detection and fixes

Key Behaviors

Classification Output