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.

1.08x

Quality

78%

Does it follow best practices?

Impact

98%

1.08x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./diataxis/SKILL.md

Evaluation results

95%

Documentation Health Check for an Open Source CLI Tool

Documentation audit with classification output format

Criteria

Without context

With context

Quadrant named per doc

100%

Confidence level per doc

100%

Evidence per doc

100%

Violation detected: getting-started anti-pattern

100%

Violation signal cited

100%

Reference correctly identified

100%

How-to correctly identified

100%

Explanation correctly identified

100%

Gaps/imbalances reported

100%

No merging recommended

100%

Compass reasoning visible

25%

37%

Imbalance characterization

100%

11%

Documentation for a New Database Migration Feature

Generate mode policy and quadrant constraint enforcement

Criteria

Without context

With context

Plan written first

100%

Quadrant reasoning in plan

70%

100%

Three quadrants produced

100%

Quadrants in separate files

100%

Tutorial uses 'we' language

100%

Tutorial avoids explanations

100%

How-to assumes competence

100%

How-to starts with action

100%

Explanation uses discursive prose

100%

Explanation covers 'why'

100%

No content-free files

100%

No quadrant blending

100%

99%

Split and Fix the Authentication Documentation

Restructure mixed-mode documentation

Criteria

Without context

With context

Plan file produced

100%

Four output documents

100%

One type per file

100%

Reference: no opinions

100%

Reference: neutral tone

100%

87%

Tutorial: minimal explanation

100%

Tutorial: learning framing

100%

Explanation: no procedures

100%

How-to: competence assumed

100%

How-to: background removed

62%

100%

No content lost

100%

No quadrant merging

100%

Repository: keithpatton/diataxis-agent-skill
Commit: 5b095a5

Evaluated: about 1 month ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Documentation Health Check for an Open Source CLI Tool Documentation for a New Database Migration Feature Split and Fix the Authentication Documentation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.