← Tutti gli articoli

Configurazione

Skill e hook di Claude Code che si ripagano in token

Ogni skill che installi è un piccolo abbonamento che paghi in contesto, a ogni sessione, che si attivi o no. Un hook è un acquisto completamente diverso — ed è in quella differenza che sta la maggior parte del denaro.

Scritto da Ted Mavera, Product Manager di HarnessUp, l'azienda che realizza lo strumento descritto qui. I testi di questo blog sono scritti con l'aiuto dell'intelligenza artificiale e revisionati dal team prima della pubblicazione.

Una macchina in ceramica color crema con cinque cartucce di skill, ognuna che rilascia dischi di moneta arancioni nel proprio tubo di vetro, una clessidra d'ottone di lato e una cartuccia sciolta davanti.

Perché esiste questo articolo

Ci sono liste di skill di Claude Code ovunque, ormai: le prime dieci, le migliori per il frontend, quelle che cambieranno il tuo flusso di lavoro. Quello che nessuna ti dice è che ogni voce di quelle liste è un acquisto, pagato nella stessa valuta del lavoro stesso, e addebitato che tu la usi o no quel giorno. La lista classifica l'utilità. Nessuno classifica il costo.

Questo pezzo fa la seconda metà. Non perché le skill siano un cattivo affare — alcune sono il miglior affare di tutto l'harness — ma perché la differenza tra una skill che si ripaga e una che tassa silenziosamente ogni sessione è una differenza misurabile, e quasi nessuno la misura.

Due modi di spendere quando aggiungi una skill

Una skill ha una definizione, e una parte di quella definizione è nel contesto del modello dal momento in cui la sessione inizia, così l'agente sa che la skill esiste e quando ricorrervi. Quella parte è il costo fisso: pagato a ogni sessione, in ogni conversazione, indipendentemente dal fatto che la skill venga mai eseguita. Quando la skill viene eseguita, il suo corpo viene caricato e le sue istruzioni plasmano i turni successivi. Quello è il costo variabile.

La metà fissa è quella che viene ignorata, e si accumula nel modo meno interessante. Dieci skill che sembrano minuscole in fondo a una sessione si sommano in un blocco che viene riletto a ogni turno di ogni conversazione. È la stessa aritmetica di qualsiasi altro contesto: ciò che sta in cima alla conversazione viene addebitato ancora e ancora, non una volta sola.

Gli hook funzionano diversamente, ed è la parte che le liste sbagliano più spesso. Un hook è un comando che l'harness esegue su un evento — prima di una chiamata a uno strumento, dopo una modifica, quando la sessione si ferma. La maggior parte degli hook non aggiunge alcun token: aggiunge latenza e cambia ciò che succede dopo. Un hook che blocca una scrittura inutile, rifiuta una lettura ripetuta o compila il progetto dopo una modifica ti costa millisecondi e può rimborsare un intero turno. In termini di token, quelli buoni sono quasi gratis; quelli cattivi sono costosi non perché leggano il contesto, ma perché falliscono, riprovano o scattano su tutto.

Come dare un prezzo a una skill prima di tenerla

Quattro domande, in quest'ordine. Quanto aggiunge al contesto iniziale? Quanti turni aggiunge o toglie quando viene eseguita? Quanto output produce? E quante volte scatta davvero in una settimana normale?

La quarta domanda è quella che decide la maggior parte dei casi. Una skill che scatta due volte al mese ma viaggia nel contesto a ogni sessione è un abbonamento a qualcosa che usi di rado. La stessa skill, se è scritta bene, costa una frazione di ciò che fa risparmiare nelle due occasioni in cui scatta — ma solo se le occasioni sono reali.

Il nostro pannello ha una schermata pensata esattamente per questo. Optimize Harness mostra il costo misurato di ogni skill, subagent, plugin e server, con un interruttore per disattivarlo, e rifiuta di proposito di tirare a indovinare: ciò che non è stato misurato non riceve un numero. Il suo vicino, Rules Auditor, fa lo stesso per le regole in CLAUDE.md, mostrando il costo fisso di ogni blocco che viene ricaricato a ogni giro — e propone un file più snello senza mai modificarlo da solo. Entrambi sono Pro; l'abitudine alla misurazione che abilitano vale più di qualsiasi singolo strumento del catalogo.

Un piccolo libro mastro aperto su un banco da officina con due colonne intestate a matita, una lente d'ingrandimento appoggiata sulla pagina sinistra e alcune viti in ottone sparse intorno.
Costo fisso su una pagina, costo variabile sull'altra. La maggior parte delle liste legge solo quella di destra.

Le categorie che di solito ripagano

Cose che fermano una rilettura. L'abitudine più costosa in una sessione con un agente è leggere lo stesso contenuto due volte. Qualunque cosa consegni prima uno scheletro e poi il corpo, rifiuti una porzione di file che l'agente ha già visto, o mantenga un riassunto stabile invece della cronologia completa, sta ricomprando contesto che altrimenti verrebbe rimandato decine di volte. Read Router restituisce l'indice di un file di contesto grande alla prima lettura e il testo completo solo se richiesto; Delta Read tiene traccia delle righe che l'agente ha già visto; Hot Context taglia la cronologia vecchia in frammenti che restano ricercabili invece che residenti.

Cose che limitano l'output degli strumenti. Un grep che restituisce seicento corrispondenze, una suite di test che stampa novecento righe, una pagina recuperata che arriva come quarantamila caratteri di navigazione: tutto entra nel contesto e resta. Head Limit taglia il risultato gigantesco di grep a ogni chiamata e insegna all'agente come chiedere il resto; Smart Cut consegna la prima pagina di un file grande con la dimensione totale; Output Diet e Terminal Guide conservano l'inizio, la fine e le righe di errore, con l'output completo lasciato su disco.

Cose che evitano un turno sprecato. Un turno è l'unità più costosa del sistema, e lo spreco classico è il turno speso a scoprire qualcosa che un compilatore sapeva già. First Pass esegue la build dopo la modifica e spinge l'errore nel turno successivo. Conduction Write blocca la scrittura che lascerebbe il file identico. Way Out, quando uno strumento fallisce, indica un esempio nel progetto che ha risolto lo stesso problema — solo quando ne esiste la prova.

Cose che accorciano la risposta. Response Diet taglia il testo di riscaldamento prima che entri nella conversazione, che è il momento più economico possibile per tagliarlo. No Comment chiede all'agente di non commentare l'ovvio e misura quanto nuovo codice arriva ancora commentato, senza toccare i commenti già esistenti.

Le categorie che di solito non ripagano

Le skill che ripetono documentazione che il modello ha già. Le skill di persona e di formattazione, a meno che il formato non sia un requisito rigido. Tre server MCP che si sovrappongono, ognuno dei quali ispeziona il progetto all'avvio. E il caso più sottile: una skill davvero utile ma installata due volte, in due versioni, con due descrizioni leggermente diverse — ora l'agente paga per entrambe e deve scegliere.

Nessuna di queste è un peccato. Sono tutti acquisti razionali fatti uno alla volta, da qualcuno a cui non è stata mostrata la ricevuta. Il problema non è la singola skill; è che la somma non è mai stata prezzata.

Un audit da 20 minuti

Elenca ciò che hai installato. Apri Optimize Harness e guarda il costo misurato per voce, poi disattiva tutto ciò che non hai usato questa settimana. Apri Rules Auditor e leggi il costo fisso dei blocchi nel tuo file di contesto — quasi tutti trovano almeno un blocco che descrive una convenzione abbandonata dal progetto. Esegui tre sessioni normali. Confronta il contesto iniziale della prima sessione con quello della quarta.

Un avvertimento, imparato a proprie spese: disattiva le cose una alla volta e annota ciò che hai rimosso. Una skill che hai disabilitato può costare in qualità più di quanto abbia risparmiato in token, e l'unico modo per saperlo è accorgersi della settimana in cui è stato tutto più silenzioso.

Cosa questo non promette

Un contesto snello non è automaticamente un buon contesto. Alcune skill si guadagnano il costo fisso evitando tre turni sbagliati al giorno, e tagliarle sarebbe la peggiore forma di risparmio. La misurazione ti dice il prezzo; non ti dice il valore. Quel giudizio resta con te, ed è anche il motivo per cui ogni strumento qui è reversibile con un clic e per cui lo strato di misurazione è gratuito: dovresti poter guardare prima di saltare.

HarnessUp stesso non è una skill, un hook, un plugin, un server MCP o un proxy. È un secondo strato locale che agisce tramite gli hook ufficiali di Claude Code e Codex e non legge mai il tuo token o la tua chiave. La distinzione conta per questo articolo: nessuno degli strumenti qui sopra aggiunge una definizione al tuo contesto iniziale come fa una skill. Lavorano sul traffico, non sul prompt.

Dai un prezzo a ciò che hai installato. Installa HarnessUp gratis e guarda il costo misurato di ogni skill, subagent e server nella tua configurazione.

Installa gratis