Diataxis Documentation Governance

Une documentation qu'un nouvel utilisateur peut vraiment suivre.

par keithpatton · keithpatton/diataxis-agent-skill

Testé · Fonctionne ★ 9.2/10

Diataxis Documentation Governance — Une documentation qu'un nouvel utilisateur peut vraiment suivre.

Ce que fait

Tutoriels, guides pratiques, références et explications, avec la bonne structure pour chacun. Notre test est brutal et simple : donner la doc à quelqu'un de nouveau et regarder où il se bloque. Personne ne s'est bloqué.

Rapport de test

A rédigé la documentation d'installation d'un vrai outil en ligne de commande ; un nouvel utilisateur l'a suivie de bout en bout sans jamais se bloquer.

Testé le: 2026-07-14 · Claude Code 2.x (agent harness)

Installation

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

Commandes et exemples de prompts

/technical-writingUne documentation qu'un nouvel utilisateur peut vraiment suivre.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →