Diataxis Documentation Governance
Clasifica y audita documentos contra los cuatro cuadrantes de Diátaxis; marca documentos de modo mixto.
Probado · Funciona
Qué hace
Aplica la brújula acción/cognición x adquisición/aplicación del marco Diátaxis para clasificar el contenido en exactamente uno de los cuatro cuadrantes de documentación, marcar violaciones de mezcla de cuadrantes y proponer divisiones. Opera en modo de clasificación, auditoría, generación o reestructuración, siempre informando confianza y evidencia. Se niega a mezclar cuadrantes o inventar información arquitectónica — explícitamente una herramienta de gobernanza/estructura, no un editor de gramática o estilo.
Informe de la prueba
Aplicar la brújula acción/cognición × adquisición/aplicación a un fragmento de configuración mixta detectó una violación estructural real — un 'por qué OAuth evolucionó' explicativo enterrado dentro de un cómo-hacer — que una lectura simple llamó 'bien, parece una guía de configuración'. (Listado aquí bajo nuestro nombre anterior; el propio nombre de la habilidad es "Diataxis Documentation Governance".)
Probado el: 2026-07-14 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/keithpatton/diataxis-agent-skill cd diataxis-agent-skill mkdir -p ~/.claude/skills cp -r diataxis ~/.claude/skills/technical-writing
Comandos y prompts de ejemplo
/technical-writingClasifica y audita documentos contra los cuatro cuadrantes de Diátaxis; marca documentos de modo mixto.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Write a tutorial a brand-new user can actually followDraft a how-to guide for setting up this APIStructure this reference doc so beginners don't get lost