Writing for Agents (ex Write a Skill)
La référence pour écrire tout document qu'un agent consomme : une skill, un AGENTS.md ou CLAUDE.md, une doc atteinte par un pointeur. Sa thèse : l'emballage change, l'écriture non, et le but est que l'agent suive le même processus à chaque exécution, pas qu'il produise la même sortie. Elle nomme les leviers. Le pointeur de contexte, dont c'est la formulation et non la cible qui décide quand l'agent va chercher la matière. Les deux budgets, charge de contexte sur la fenêtre et charge cognitive sur l'humain. La hiérarchie d'information à trois barreaux, étape dans le fichier, référence dans le fichier, référence divulguée derrière un pointeur. Et le critère de complétion de chaque étape, jugé sur sa clarté (peut-on distinguer fini de pas fini) et sur son exigence.
Forces
- Traite la description d'une skill comme le vrai levier de déclenchement, avec des règles concrètes de formulation
- Sépare charge de contexte et charge cognitive, et dit laquelle on cherche à réduire et laquelle on assume
- Hiérarchie d'information à trois barreaux avec un test de branchement pour décider ce qui descend derrière un pointeur
- Nomme les modes d'échec (complétion prématurée, sprawl, négation, espace négatif) avec leur remède, pas seulement leur symptôme
Limites
- Dense et abstraite : sa lecture demande un vrai effort, et ce n'est pas une checklist à appliquer en dix minutes
- Vocabulaire propre à Matt Pocock qui ne recoupe pas celui de la doc officielle Anthropic sur les skills
- A déjà été renommée deux fois (write-a-skill, puis writing-great-skills, puis celle-ci) : les liens externes cassent vite
Pour qui
- Auteurs de skills dont les skills ne se déclenchent jamais toutes seules
- Équipes qui maintiennent un CLAUDE.md ou AGENTS.md devenu trop long pour être suivi
- Repos agent-first où deux exécutions de la même consigne ne donnent pas le même processus