Compact Docs Writer
Schrumpft versionskontrollierte, Agent-lesbare Dokumente für die Token-Ökonomie, ohne Regeln zu entfernen, als Diff angezeigt.
Getestet · Funktioniert
Was es kann
Schreibt oder entwirft ein Dokument (z.B. CONTRIBUTING.md, CLAUDE.md, eine Skill-Datei) neu, um jede Regel und Einschränkung mit den wenigsten möglichen Worten zu vermitteln, da diese Dokumente von Agenten in jeder Sitzung erneut gelesen werden. Wendet einen No-Op-Test an, um jede Löschung zu rechtfertigen, fasst wiederkehrende Konzepte in einzelnen 'führenden Wörtern' zusammen und präsentiert das Ergebnis als umzäunten Diff mit einem Wort-/Token-Delta, gemessen mit `wc -w` statt geschätzt, und wendet es nur nach expliziter Genehmigung an. Überspringt explizit Wegwerf-Dokumente wie einmalige Pläne.
Testbericht
Upstream hat sich tatsächlich an unserem Testtag geändert (Commit 'improve self-test', 2026-07-16 14:32), aber der Diff zeigt, dass es sich um einen Versionssprung 1.4 → 1.5 plus einen hinzugefügten Selbstüberprüfungspunkt handelt: 'addition audit' — jeder hinzugefügte Satz muss nun auch einen No-Op-Test bestehen. Dies ist eine Verschärfung eines bestehenden Verfahrens, keine Problembehebung oder ein neues Risiko, daher bleibt das positive Urteil bestehen. Das Protokoll von Grund auf neu auf der neuen Version ausgeführt: Installationsbefehl funktioniert wortgetreu, Frontmatter geparst (name, description, allowed-tools, license), der Skill zieht überhaupt keine externen Dateien, Stufe 0 sauber — keine Skripte, Netzwerk oder versteckte Anweisungen. Live A/B auf einem erweiterten Code-Review-Regel-Dokument (319 Wörter, gemessen über wc -w): Baseline komprimierte auf 70 Wörter, ließ aber stillschweigend die Begründung für drei Regeln fallen (warum Prüfer aus dem verantwortlichen Team, warum 24 Stunden Antwortzeit, warum 400-Zeilen-Limit), während die Ausführung mit dem Skill-Body 117 Wörter ergab und alle acht Regeln und deren 'Warum' bewahrte. Gleiches Muster wie beim letzten Mal: Baseline ist kürzer, der Skill ist der einzige, der die Absicht nicht verliert.
Getestet am: 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
Befehle & Beispiel-Prompts
/compact-docs-writerSchrumpft versionskontrollierte, Agent-lesbare Dokumente für die Token-Ökonomie, ohne Regeln zu entfernen, als Diff angezeigt.
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
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