Compact Docs Writer
Zmniejsza kontrolowane wersjami dokumenty czytane przez agentów dla oszczędności tokenów, bez pomijania żadnej reguły, pokazane jako diff.
Testowano · Działa
Co robi ten skill
Przepisuje lub szkicuje dokument (np. CONTRIBUTING.md, CLAUDE.md, plik umiejętności), aby zawierał każdą zasadę i ograniczenie w jak najmniejszej liczbie słów, ponieważ te dokumenty są ponownie czytane przez agentów podczas każdej sesji. Stosuje test no-op, aby uzasadnić każde usunięcie, łączy powtarzające się koncepcje w pojedyncze 'słowa kluczowe' i przedstawia wynik jako ogrodzony diff z delty słów/tokenów mierzoną za pomocą `wc -w`, a nie szacowaną, stosowaną tylko po wyraźnym zatwierdzeniu. Wyraźnie pomija dokumenty jednorazowe, takie jak plany ad hoc.
Raport z testu
Upstream faktycznie zmienił się w dniu naszego testu (commit 'improve self-test', 2026-07-16 14:32), ale diff pokazuje, że jest to podbicie wersji 1.4 → 1.5 plus jeden dodany element samooceny: 'addition audit' — każde dodane zdanie musi teraz również przejść test no-op. Jest to zaostrzenie istniejącej procedury, a nie naprawa problemu ani nowe ryzyko, więc werdykt pozytywny pozostaje. Ponownie uruchomiono protokół od zera na nowej wersji: polecenie instalacji działa dosłownie, frontmatter sparsowany (name, description, allowed-tools, license), umiejętność nie pobiera żadnych zewnętrznych plików, Etap 0 czysty — brak skryptów, sieci lub ukrytych instrukcji. Test A/B na żywo na rozszerzonym dokumencie zasad przeglądu kodu (319 słów, zmierzonych za pomocą wc -w): linia bazowa skompresowana do 70 słów, ale cicho pominęła uzasadnienie dla trzech zasad (dlaczego recenzent z zespołu właścicielskiego, dlaczego 24 godziny na odpowiedź, dlaczego limit 400 linii), podczas gdy uruchomienie z treścią umiejętności dało 117 słów i zachowało wszystkie osiem zasad i ich 'dlaczego'. Ten sam wzorzec co ostatnio: linia bazowa jest krótsza, umiejętność jest jedyną, która nie traci intencji.
Testowano: 2026-07-16 · Claude Code 2.x (agent harness)
Instalacja
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
Komendy i przykładowe prompty
/compact-docs-writerZmniejsza kontrolowane wersjami dokumenty czytane przez agentów dla oszczędności tokenów, bez pomijania żadnej reguły, pokazane jako diff.
Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):
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