Compact Docs Writer
Réduit la taille des documents lus par les agents et versionnés pour l'économie de jetons sans supprimer de règle, affiché sous forme de diff.
Testé · Fonctionne
Ce que fait
Réécrit ou rédige un document (par exemple CONTRIBUTING.md, CLAUDE.md, un fichier de compétence) pour contenir chaque règle et contrainte avec le moins de mots possible, car ces documents sont relus par les agents à chaque session. Applique un test no-op pour justifier chaque suppression, condense les concepts récurrents en 'mots clés' uniques, et présente le résultat sous forme de diff délimité avec un delta de mots/jetons mesuré avec `wc -w` plutôt qu'estimé, s'appliquant uniquement après approbation explicite. Ignore explicitement les documents jetables comme les plans ponctuels.
Rapport de test
L'amont a effectivement changé le jour de notre test (commit 'improve self-test', 2026-07-16 14:32), mais le diff montre qu'il s'agit d'une augmentation de version 1.4 → 1.5 plus un élément d'auto-révision ajouté : 'addition audit' — chaque phrase ajoutée doit maintenant également passer un test no-op. Il s'agit d'un renforcement d'une procédure existante, pas d'une correction de problème ou d'un nouveau risque, donc le verdict de réussite est maintenu. Protocole réexécuté de zéro sur la nouvelle version : la commande d'installation fonctionne verbatim, le frontmatter est parsé (name, description, allowed-tools, license), la compétence ne tire aucun fichier externe, Stage 0 propre — pas de scripts, de réseau ou d'instructions cachées. A/B en direct sur un document de règles de revue de code étendu (319 mots, mesuré via wc -w) : la base de référence compressée à 70 mots mais a silencieusement supprimé la justification de trois règles (pourquoi un relecteur de l'équipe propriétaire, pourquoi 24 heures pour répondre, pourquoi une limite de 400 lignes), tandis que l'exécution avec le corps de la compétence a donné 117 mots et a préservé les huit règles et leur 'pourquoi'. Même schéma que la dernière fois : la base de référence est plus courte, la compétence est la seule qui ne perd pas l'intention.
Testé le: 2026-07-16 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/FrancescoBorzi/agent-toolkit.git mkdir -p ~/.claude/skills cp -r agent-toolkit/skills/compact-docs-writer ~/.claude/skills/compact-docs-writer
Commandes et exemples de prompts
/compact-docs-writerRéduit la taille des documents lus par les agents et versionnés pour l'économie de jetons sans supprimer de règle, affiché sous forme de diff.
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) :
shrink this CONTRIBUTING.md without losing any of the actual rulesmake my CLAUDE.md shorter but keep the reasoning behind each ruleshow me a diff of the token savings after trimming this doc