Come Creare una Skill per Claude Code

Nell'ultimo periodo sono passato a Claude Code come ambiente principale di lavoro e ho scoperto un ecosistema molto più ricco di quanto pensassi. Le skill sono una delle cose che mi hanno colpito di più: concettualmente simili ai GPT di ChatGPT, ma integrate in tutto l'ecosistema — funzionano nelle chat, in Cowork e nel Codice, e sono interscambiabili tra i diversi contesti.

Creare una skill è abbastanza semplice: tutto parte da una conversazione con l'AI. Non serve scrivere codice a mano, non serve conoscere la struttura interna. Si descrive quello che si vuole ottenere e Claude fa il resto.

Definire Cosa Deve Fare la Skill

Prima di aprire qualsiasi strumento, serve avere chiaro cosa la skill deve fare: quali passaggi seguire, quali decisioni prendere, quale output produrre. Il ragionamento si può fare da soli con carta e penna, oppure direttamente con Claude in una chat normale. Io di solito uso Claude anche per questa fase: descrivo il problema a parole e lui mi aiuta a strutturare il flusso logico prima ancora di costruire qualcosa.

Aprire Cowork e Configurare il Modello

Per creare una skill consiglio di usare Cowork anziché la chat normale. Il motivo è pratico: Cowork combina chat e ambiente di lavoro nella stessa interfaccia, tiene traccia di tutti i file generati e permette di accedere a tutto il contesto del progetto in un colpo solo — come avere una scrivania invece di un foglio di carta.

Configurazione iniziale: selezionare 'Nuova attività', non associare un progetto specifico (la skill sarà globale, usabile ovunque), e scegliere il modello più capace disponibile. Ad aprile 2026 uso Opus 4.6 — le skill sono istruzioni complesse e vale la pena usare il modello migliore per costruirle bene.

Chiedere a Claude di Creare la Skill

Il passaggio centrale è semplice: descrivere a Claude cosa la skill deve fare, in modo chiaro e dettagliato. Claude ha già documentazione interna sulle skill — conosce il formato, le convenzioni, come strutturarle. Non serve guidarlo su questo. Nel mio caso ho descritto che volevo una skill per gestire gli articoli del portfolio: aggiungere nuovi post, modificare quelli esistenti, mantenere sincronizzati i metadati tra due file.

Claude inizia il ragionamento, a volte fa domande di chiarimento, a volte va avanti per conto suo. Quando la skill è pronta fornisce un'analisi di cosa è stato costruito, quali casi gestisce e come usarla. Vale la pena leggere questa analisi: spesso include dettagli o casistiche che non avevo esplicitamente richiesto.

Testare Prima di Tutto

Questo è il passaggio che mi sono abituato a non saltare mai. Prima di installare la skill ovunque, la si testa nella stessa chat in cui è stata creata. Non funziona quasi mai perfettamente al primo colpo: manca un caso limite, un'istruzione è ambigua, l'output non è esattamente nel formato che serviva.

Se qualcosa non va, si dice a Claude cosa non funziona e si chiede di correggere. A volte Claude stesso propone miglioramenti che non avevo pensato — passaggi aggiuntivi, controlli di coerenza, formati di output alternativi. È un processo iterativo, e nella mia esperienza bastano uno o due giri per arrivare a qualcosa di solido.

Trovare e Aggiungere la Skill

La skill non viene aggiunta automaticamente alle competenze di Claude: una volta creata, è salvata come file in una cartella specifica del sistema. Per trovarla: cliccare su 'Vedi la Skill creata' nel pannello di Cowork, poi 'Mostra nella cartella' per aprire la directory.

Per installarla: andare su Personalizza → Competenze → + → Carica una skill. Si seleziona il file dalla cartella e da quel momento la skill è disponibile ovunque nell'ecosistema — nelle chat, in Cowork, nel Codice.

Usare la Skill

Nelle chat: basta digitare / nella barra del messaggio e selezionare la skill dal menu. Nel Codice: scrivere 'utilizza la skill [nome] per...' direttamente nel prompt. La skill viene richiamata e segue le istruzioni definite al suo interno.

Un avvertimento pratico: se si creano più skill simili, Claude può confondersi su quale usare o applicarle in modo sovrapposto. Conviene tenere le skill ben distinte per ambito e non duplicare logiche simili in skill diverse.

Modificare una Skill

Le skill non sono statiche: si possono modificare in qualsiasi momento. Da Personalizza → Competenze → tre puntini accanto alla skill, si hanno due opzioni: modifica in linea (apertura diretta del file, modifiche manuali al testo) oppure modifica con Claude (si descrive la modifica in linguaggio naturale e Claude aggiorna la skill in modo conversazionale). La seconda è quella che uso quasi sempre — è più veloce e riduce il rischio di introdurre errori di sintassi.

All'inizio non capivo il senso di costruire skill: usavo le chat direttamente e mi sembrava sufficiente. Più ci lavoro, più capisco quanto tempo fanno risparmiare sui task lineari e ripetitivi — quelli in cui il processo è definito ma l'esecuzione richiede attenzione. La skill porta tutta quella attenzione una volta sola, nella costruzione. Poi si replica senza sforzo.

Il mio consiglio è partire da qualcosa di piccolo: un task che fai spesso, con passaggi chiari e output prevedibile. Costruire la prima skill su qualcosa di semplice aiuta a capire la logica senza essere sopraffatti. Da lì in poi si scopre rapidamente quanto questo approccio scala.