Compact Docs Writer

Krymper versionskontrollerede agent-læste docs for token-økonomi uden at fjerne nogen regel, vist som en diff.

Af FrancescoBorzi · FrancescoBorzi/agent-toolkit

Testet · Virker ★ 9.2/10

Compact Docs Writer — Krymper versionskontrollerede agent-læste docs for token-økonomi uden at fjerne nogen regel, vist som en diff.

Hvad det gør

Omskriver eller udarbejder et dokument (f.eks. CONTRIBUTING.md, CLAUDE.md, en skill-fil) for at indeholde hver regel og begrænsning med færrest mulige ord, da disse dokumenter genlæses af agenter i hver session. Anvender en no-op test for at begrunde hver sletning, kollapser tilbagevendende koncepter til enkelte 'ledende ord' og præsenterer resultatet som en fenced diff med en ord-/token-delta målt med `wc -w` snarere end estimeret, og anvender kun efter udtrykkelig godkendelse. Springer eksplicit engangsdokumenter som engangsplaner over.

Testrapport

Upstream ændrede sig faktisk på vores testdag (commit 'improve self-test', 2026-07-16 14:32), men diff'en viser, at det er en versionsopdatering 1.4 → 1.5 plus et tilføjet selvgennemgangspunkt: 'addition audit' — hver tilføjet sætning skal nu også bestå en no-op test. Dette er en stramning af en eksisterende procedure, ikke en problemløsning eller en ny risiko, så beståelsesdommen forbliver. Genkørte protokollen fra bunden på den nye version: installationskommandoen fungerer ordret, frontmatter parset (name, description, allowed-tools, license), skillen trækker ingen eksterne filer overhovedet, Stage 0 ren — ingen scripts, netværk eller skjulte instruktioner. Live A/B på et udvidet kodegennemgangsregler-dokument (319 ord, målt via wc -w): baseline komprimerede til 70 ord, men droppede lydløst begrundelsen for tre regler (hvorfor anmelder fra ejerteam, hvorfor 24 timer til at svare, hvorfor 400-linjers grænse), mens kørsel med skillens brødtekst gav 117 ord og bevarede alle otte regler og deres 'hvorfor'. Samme mønster som sidste gang: baseline er kortere, skillen er den eneste, der ikke mister intentionen.

Testet: 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

Kommandoer og eksempelprompter

  • /compact-docs-writerKrymper versionskontrollerede agent-læste docs for token-økonomi uden at fjerne nogen regel, vist som en diff.

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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