Compact Docs Writer
Zmenšuje verzované dokumenty čtené agenty pro úsporu tokenů bez vypuštění jakéhokoli pravidla, zobrazeno jako diff.
Otestováno · Funguje
Co umí
Přepisuje nebo navrhuje dokument (např. CONTRIBUTING.md, CLAUDE.md, soubor skillu) tak, aby obsahoval každé pravidlo a omezení co nejmenším počtem slov, jelikož tyto dokumenty jsou agenty znovu čteny při každé relaci. Aplikuje no-op test k odůvodnění každého smazání, slučuje opakující se koncepty do jednotlivých 'klíčových slov' a prezentuje výsledek jako ohraničený diff s rozdílem slov/tokenů měřeným pomocí `wc -w` namísto odhadu, aplikuje se pouze po explicitním schválení. Explicitně přeskočí jednorázové dokumenty, jako jsou jednorázové plány.
Testovací report
Upstream se skutečně změnil v den našeho testu (commit 'improve self-test', 16.07.2026 14:32), ale diff ukazuje, že se jedná o zvýšení verze 1.4 → 1.5 plus jednu přidanou položku samo-revize: 'addition audit' — každá přidaná věta nyní musí také projít no-op testem. Jedná se o zpřísnění stávajícího postupu, nikoli o opravu problému nebo nové riziko, takže verdikt o průchodu zůstává. Znovu jsem spustil protokol od začátku na nové verzi: instalační příkaz funguje doslovně, frontmatter parsován (name, description, allowed-tools, license), skill nestahuje žádné externí soubory, Stage 0 čisté — žádné skripty, síť ani skryté instrukce. Živý A/B test na rozšířeném dokumentu pravidel pro revizi kódu (319 slov, měřeno pomocí wc -w): základní verze komprimována na 70 slov, ale tiše vypustila odůvodnění pro tři pravidla (proč recenzent z vlastnického týmu, proč 24 hodin na odpověď, proč limit 400 řádků), zatímco spuštění s tělem skillu přineslo 117 slov a zachovalo všech osm pravidel a jejich 'proč'. Stejný vzor jako minule: základní verze je kratší, skill je jediný, který neztrácí záměr.
Testováno: 2026-07-16 · Claude Code 2.x (agent harness)
Instalace
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
Příkazy a ukázkové prompty
/compact-docs-writerZmenšuje verzované dokumenty čtené agenty pro úsporu tokenů bez vypuštění jakéhokoli pravidla, zobrazeno jako diff.
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
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