Compact Docs Writer
Riduce la dimensione di documenti letti da agenti e versionati per l'economia dei token senza eliminare alcuna regola, mostrato come un diff.
Promosso
Cosa fa
Riscrive o redige un documento (es. CONTRIBUTING.md, CLAUDE.md, un file skill) per contenere ogni regola e vincolo nel minor numero possibile di parole, poiché questi documenti vengono riletti dagli agenti ad ogni sessione. Applica un test no-op per giustificare ogni eliminazione, raggruppa concetti ricorrenti in singole 'parole chiave' e presenta il risultato come un diff recintato con un delta di parole/token misurato con `wc -w` anziché stimato, applicando solo dopo approvazione esplicita. Salta esplicitamente documenti usa e getta come piani una tantum.
Rapporto di test
L'upstream è effettivamente cambiato il giorno del nostro test (commit 'improve self-test', 2026-07-16 14:32), ma il diff mostra che si tratta di un incremento di versione 1.4 → 1.5 più un elemento di auto-revisione aggiunto: 'addition audit' — ogni frase aggiunta deve ora superare anche un test no-op. Si tratta di un inasprimento di una procedura esistente, non di una correzione di un problema o di un nuovo rischio, quindi il verdetto di successo rimane. Rilanciato il protocollo da zero sulla nuova versione: il comando di installazione funziona alla lettera, il frontmatter è stato parsato (name, description, allowed-tools, license), la skill non scarica alcun file esterno, Fase 0 pulita — nessun script, rete o istruzioni nascoste. A/B dal vivo su un documento di regole di revisione del codice espanso (319 parole, misurate tramite wc -w): la baseline compressa a 70 parole ma ha silenziosamente eliminato la giustificazione per tre regole (perché il revisore del team proprietario, perché 24 ore per rispondere, perché limite di 400 righe), mentre l'esecuzione con il corpo della skill ha prodotto 117 parole e ha preservato tutte e otto le regole e il loro 'perché'. Stesso schema dell'ultima volta: la baseline è più breve, la skill è l'unica che non perde l'intento.
Testato il: 2026-07-16 · Claude Code 2.x (agent harness)
Installazione
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
Comandi e prompt di esempio
/compact-docs-writerRiduce la dimensione di documenti letti da agenti e versionati per l'economia dei token senza eliminare alcuna regola, mostrato come un diff.
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
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