Compact Docs Writer
Verkleint versiebeheerde, door agenten gelezen documenten voor token-economie zonder regels te laten vallen, getoond als een diff.
Getest · Werkt
Wat het doet
Herschrijft of ontwerpt een document (bijv. CONTRIBUTING.md, CLAUDE.md, een skill-bestand) om elke regel en beperking in zo min mogelijk woorden te bevatten, aangezien deze documenten bij elke sessie opnieuw worden gelezen door agenten. Past een no-op test toe om elke verwijdering te rechtvaardigen, voegt terugkerende concepten samen tot enkele 'leidende woorden', en presenteert het resultaat als een fenced diff met een woord/token delta gemeten met `wc -w` in plaats van geschat, alleen toepassend na expliciete goedkeuring. Slaat expliciet wegwerpdocumenten zoals eenmalige plannen over.
Testrapport
Upstream is inderdaad gewijzigd op onze testdag (commit 'improve self-test', 2026-07-16 14:32), maar de diff toont aan dat het een versie-update is van 1.4 → 1.5 plus één toegevoegd zelf-review item: 'addition audit' — elke toegevoegde zin moet nu ook een no-op test doorstaan. Dit is een aanscherping van een bestaande procedure, geen probleemoplossing of een nieuw risico, dus het positieve oordeel blijft. Voerde het protocol opnieuw uit vanaf nul op de nieuwe versie: installatiecommando werkt woordelijk, frontmatter geparsed (name, description, allowed-tools, license), de skill haalt helemaal geen externe bestanden op, Stage 0 schoon — geen scripts, netwerk of verborgen instructies. Live A/B op een uitgebreid document met codereviewregels (319 woorden, gemeten via wc -w): baseline gecomprimeerd tot 70 woorden maar liet stilzwijgend de rechtvaardiging voor drie regels vallen (waarom reviewer van eigenaarschapsteam, waarom 24 uur om te reageren, waarom 400-regellimiet), terwijl het uitvoeren met de body van de skill 117 woorden opleverde en alle acht regels en hun 'waarom' behield. Zelfde patroon als de vorige keer: baseline is korter, de skill is de enige die de intentie niet verliest.
Getest op: 2026-07-16 · Claude Code 2.x (agent harness)
Installatie
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
Commando's en voorbeeldprompts
/compact-docs-writerVerkleint versiebeheerde, door agenten gelezen documenten voor token-economie zonder regels te laten vallen, getoond als een diff.
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
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