Compact Docs Writer

Krymper versjonskontrollerte agent-lesbare dokumenter for token-økonomi uten å fjerne noen regel, vist som en diff.

av FrancescoBorzi · FrancescoBorzi/agent-toolkit

Bestått ★ 9.2/10

Compact Docs Writer — Krymper versjonskontrollerte agent-lesbare dokumenter for token-økonomi uten å fjerne noen regel, vist som en diff.

Hva den gjør

Omskriver eller utarbeider et dokument (f.eks. CONTRIBUTING.md, CLAUDE.md, en ferdighetsfil) for å inneholde hver regel og begrensning med færrest mulig ord, siden disse dokumentene leses på nytt av agenter i hver sesjon. Anvender en no-op-test for å rettferdiggjøre hver sletting, kollapser tilbakevendende konsepter til enkeltstående 'ledende ord', og presenterer resultatet som en avgrenset diff med en ord-/token-delta målt med `wc -w` snarere enn estimert, og anvendes kun etter eksplisitt godkjenning. Hopper eksplisitt over engangsdokumenter som engangsplaner.

Testrapport

Oppstrøms endret seg faktisk på testdagen vår (commit 'improve self-test', 2026-07-16 14:32), men diffen viser at det er en versjonsoppdatering 1.4 → 1.5 pluss ett lagt til selv-gjennomgangselement: 'addition audit' — hver lagt til setning må nå også bestå en no-op-test. Dette er en innstramming av en eksisterende prosedyre, ikke en problemløsning eller en ny risiko, så bestått-dommen forblir. Kjørte protokollen på nytt fra bunnen av på den nye versjonen: installasjonskommandoen fungerer ordrett, frontmatter parset (name, description, allowed-tools, license), ferdigheten trekker ingen eksterne filer i det hele tatt, Trinn 0 rent — ingen skript, nettverk eller skjulte instruksjoner. Live A/B på et utvidet dokument med kodegjennomgangsregler (319 ord, målt via wc -w): grunnlinjen komprimerte til 70 ord, men droppet stilltiende begrunnelsen for tre regler (hvorfor anmelder fra eierteam, hvorfor 24 timer å svare, hvorfor 400-linjers grense), mens kjøring med ferdighetens kropp ga 117 ord og bevarte alle åtte regler og deres 'hvorfor'. Samme mønster som sist: grunnlinjen er kortere, ferdigheten er den eneste som ikke mister intensjon.

Testet på: 2026-07-16 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

  • /compact-docs-writerKrymper versjonskontrollerte agent-lesbare dokumenter for token-økonomi uten å fjerne noen regel, vist som en diff.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

  • shrink this CONTRIBUTING.md without losing any of the actual rules
  • make my CLAUDE.md shorter but keep the reasoning behind each rule
  • show me a diff of the token savings after trimming this doc