Diataxis Documentation Governance

Classifica e audita i documenti rispetto ai quattro quadranti Diátaxis; segnala documenti a modalità mista.

di keithpatton · keithpatton/diataxis-agent-skill

Promosso ★ 9.2/10

Diataxis Documentation Governance — Classifica e audita i documenti rispetto ai quattro quadranti Diátaxis; segnala documenti a modalità mista.

Cosa fa

Applica la bussola azione/cognizione x acquisizione/applicazione del framework Diátaxis per classificare il contenuto in esattamente uno dei quattro quadranti di documentazione, segnalare violazioni di mescolanza di quadranti e proporre divisioni. Opera in modalità classifica, audit, genera o ristruttura, riportando sempre confidenza ed evidenza. Rifiuta di mescolare quadranti o inventare informazioni — esplicitamente uno strumento di governance/struttura, non un editor di grammatica o stile.

Rapporto di test

Applicando la bussola azione/cognizione × acquisizione/applicazione a uno snippet misto ha catturato una vera violazione strutturale — un 'perché OAuth si è evoluto' esplicativo nascosto all'interno di un how-to — che una semplice lettura ha definito 'ok, sembra una guida di configurazione'. (Elencato qui con il nostro vecchio nome; il nome dell'abilità stessa è "Diataxis Documentation Governance".)

Testato il: 2026-07-14 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

  • /technical-writingClassifica e audita i documenti rispetto ai quattro quadranti Diátaxis; segnala documenti a modalità mista.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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