Compact Docs Writer

Krymper versionskontrollerade agentlästa dokument för tokenekonomi utan att tappa någon regel, visas som en diff.

av FrancescoBorzi · FrancescoBorzi/agent-toolkit

Testad · Fungerar ★ 9.2/10

Compact Docs Writer — Krymper versionskontrollerade agentlästa dokument för tokenekonomi utan att tappa någon regel, visas som en diff.

Vad den gör

Skriver om eller utformar ett dokument (t.ex. CONTRIBUTING.md, CLAUDE.md, en skill-fil) för att bära varje regel och begränsning med så få ord som möjligt, eftersom dessa dokument läses om av agenter vid varje session. Tillämpar ett no-op-test för att motivera varje radering, komprimerar återkommande koncept till enstaka 'ledande ord', och presenterar resultatet som en inhägnad diff med en ord-/tokendelta mätt med `wc -w` snarare än uppskattad, tillämpas endast efter explicit godkännande. Hoppar uttryckligen över engångsdokument som engångsplaner.

Testrapport

Uppströms ändrades verkligen på vår testdag (commit 'improve self-test', 2026-07-16 14:32), men diffen visar att det är en versionsuppdatering 1.4 → 1.5 plus ett tillagt självgranskningsobjekt: 'addition audit' — varje tillagd mening måste nu också klara ett no-op-test. Detta är en åtstramning av en befintlig procedur, inte en problemfix eller en ny risk, så godkännandedomen kvarstår. Körde protokollet från grunden igen på den nya versionen: installationskommandot fungerar ordagrant, frontmatter parsades (name, description, allowed-tools, license), skillen hämtar inga externa filer alls, Steg 0 rent — inga skript, nätverk eller dolda instruktioner. Live A/B på ett utökat dokument med kodgranskningsregler (319 ord, mätt via wc -w): baslinjen komprimerades till 70 ord men tappade tyst motiveringen för tre regler (varför granskare från ägande team, varför 24 timmar att svara, varför 400-raders gräns), medan körning med skillens kropp gav 117 ord och bevarade alla åtta regler och deras 'varför'. Samma mönster som förra gången: baslinjen är kortare, skillen är den enda som inte förlorar avsikten.

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

Kommandon och exempelprompter

  • /compact-docs-writerKrymper versionskontrollerade agentlästa dokument för tokenekonomi utan att tappa någon regel, visas som en diff.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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