Diataxis Documentation Governance

Diataxis Documentatie Governance: Classificeert en auditeert docs tegen de vier Diátaxis-kwadranten; markeert gemengde documenten.

Door keithpatton · keithpatton/diataxis-agent-skill

Getest · Werkt ★ 9.2/10

Diataxis Documentation Governance — Diataxis Documentatie Governance: Classificeert en auditeert docs tegen de vier Diátaxis-kwadranten; markeert gemengde documenten.

Wat het doet

Past het actie/cognitie x acquisitie/toepassing kompas van het Diátaxis-framework toe om inhoud in precies één van de vier documentatiekwadranten te classificeren, schendingen van kwadrant-mixing te markeren en splitsingen voor te stellen. Werkt in classificeren, auditen, genereren of herstructureren modus, rapporteert altijd vertrouwen en bewijs. Weigert kwadranten te mengen of informatiearchitectuur te verzinnen — expliciet een governance/structuurtool, geen grammatica- of stijlredacteur.

Testrapport

Het toepassen van het actie/cognitie × acquisitie/toepassing kompas op een gemengde setup-snippet ving een echte structurele schending — een verklarende 'waarom OAuth evolueerde' terzijde begraven binnen een how-to — die een simpele doorlezing 'oké, ziet eruit als een setup-gids' noemde. (Hier vermeld onder onze oudere naam; de eigen naam van de skill is "Diataxis Documentation Governance".)

Getest op: 2026-07-14 · Claude Code 2.x (agent harness)

Installatie

git clone https://github.com/keithpatton/diataxis-agent-skill
cd diataxis-agent-skill
mkdir -p ~/.claude/skills
cp -r diataxis ~/.claude/skills/technical-writing

Commando's en voorbeeldprompts

  • /technical-writingDiataxis Documentatie Governance: Classificeert en auditeert docs tegen de vier Diátaxis-kwadranten; markeert gemengde documenten.

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Write a tutorial a brand-new user can actually follow
  • Draft a how-to guide for setting up this API
  • Structure this reference doc so beginners don't get lost