Le skill di Claude Code: insegnare un metodo una volta sola

C’è un momento, quando si lavora con un assistente AI, in cui ti accorgi di ripetere sempre le stesse istruzioni: «prendi questi dati, mettili nel formato aziendale, calcola i totali e scrivi il riepilogo». La prima volta è normale spiegarlo. Alla decima, un po’ meno. Le skill di Claude Code servono esattamente a questo: insegnare una procedura una volta sola e poi richiamarla con una parola.

Cos’è una skill, in concreto

Una skill è una piccola cartella con dentro un file di istruzioni (si chiama SKILL.md) e, se servono, degli script o dei modelli di documento. In quel file scrivi il metodo: cosa fare, in che ordine, con quali accorgimenti. Da quel momento Claude Code conosce quella procedura e la sa applicare quando serve.

La differenza rispetto a scrivere le istruzioni ogni volta nella chat è che la skill resta. Non la ripeti, non rischi di dimenticare un passaggio, e soprattutto la applichi allo stesso modo tutte le volte. È la differenza tra spiegare a voce come si compila un modulo e avere il modulo già pronto con le regole scritte accanto.

Come Claude decide quando usarla

Ogni skill ha un nome e una breve descrizione di quando va usata. Claude Code legge prima quella descrizione e carica il contenuto completo solo quando la richiesta corrisponde. È un meccanismo di caricamento progressivo: l’assistente non si porta dietro tutte le procedure contemporaneamente, ma pesca quella giusta al momento giusto.

In pratica puoi lavorare in due modi. Puoi invocare la skill in modo esplicito, scrivendo il suo nome preceduto dalla barra — per esempio /report — oppure puoi semplicemente descrivere quello che ti serve: se combacia con la descrizione della skill, Claude la usa da solo. La seconda modalità è comoda perché non devi ricordarti i nomi: basta chiedere.

Un esempio di lavoro reale

Immagina un resoconto settimanale che devi produrre ogni lunedì: stessi passaggi, stesso formato, stessa struttura del documento finale. Senza skill, ogni settimana rispieghi il procedimento o copi-incolli le istruzioni da qualche parte. Con una skill, scrivi una volta come si fa — dove prendere i dati, come impaginarli, quali controlli fare prima di consegnare — e poi ogni lunedì ti basta richiamarla. Il tempo che risparmi non è tanto nella singola esecuzione, quanto nel non dover più tenere a mente il metodo.

Lo stesso vale per tutto ciò che ha una forma ricorrente: una risposta tipo a un cliente, un documento su carta intestata, la preparazione di un file secondo uno standard preciso. Ogni volta che ti senti dire «questa cosa la faccio sempre uguale», probabilmente c’è una skill che aspetta di essere scritta.

Skill, agent e hook: non confonderli

Le skill vivono accanto ad altri strumenti di Claude Code, ed è utile capire dove finisce una e inizia l’altra:

• La skill è un metodo che insegni: «ecco come si fa questa cosa».
• L’agent è un esecutore a cui deleghi un pezzo di lavoro mentre tu vai avanti con il resto: «occupati tu di questo».
• L’hook è un’automazione che scatta da sola a un certo evento, senza che tu la chieda: «ogni volta che succede X, fai Y».

Detta in modo semplice: la skill la richiami tu quando serve, l’agent lavora per conto suo su un compito, l’hook parte in automatico. Tre strumenti diversi per tre esigenze diverse, che spesso si usano insieme.

Da dove partire

Il modo migliore per iniziare non è progettare la skill perfetta, ma osservare cosa ripeti già. Prendi una procedura che fai spesso e sempre nello stesso modo, scrivila come se dovessi spiegarla a un collega nuovo, e trasformala in skill. Bastano poche righe chiare per avere qualcosa di utile fin da subito; la si affina strada facendo, mano a mano che noti cosa manca.

Le skill sono lo strumento che fa passare l’assistente da «bravo a rispondere» a «cucito sul tuo modo di lavorare». E il bello è che il lavoro di scriverle lo fai una volta: da lì in poi, lavora per te.

Fausto Pitzalis

Blogger dal 2001, Nativo Digitale, Developer.
Da 15 anni mi occupo di IT per una grande Azienda.
Lavoro per abbattere il Digital Divide.
Visita i miei altri progetti
sardiniamobility.com
www.cyberness.it