Come creare una skill per Claude Code e attivarla dove serve

Creare una skill per Claude Code: il lavoro che smetti di rispiegare

Per creare una skill per Claude Code scrivi una volta sola, in un file, come fai un lavoro che ripeti sempre uguale: quel lavoro diventa un comando, e Claude lo fa nel tuo modo senza che tu glielo rispieghi ogni volta. Rispondere alle recensioni, il post del giorno, la chiusura di cassa. Ti servono una cartella nel tuo progetto e un file di testo che si chiama SKILL.md; poi lo provi con richieste vere.

Claude Code è il programma di Anthropic che lavora sui file di una cartella del tuo computer. Non è gratis: il piano gratuito di Claude non lo include (documentazione di Claude Code, pagina dei piani, verificato a novembre 2026). Se usi solo la chat di Claude, la risposta è nelle domande frequenti in fondo.

L'esempio di questa guida è il bar «Da Rosa» di Catania, che non esiste: l'abbiamo inventato noi, insieme a Rosa e alle sue recensioni. Prima Rosa apre una chat, incolla le sue regole (firma Rosa, niente sconti, mai «Gentile cliente», l'indirizzo a cui scrivere), incolla la recensione, corregge. Il giorno dopo ricomincia da capo. Dopo incolla la recensione e chiede cosa rispondere, e le regole ci sono già. Le recensioni contano anche per farsi trovare: nella guida alla scheda Google della tua attività c'è il perché, e come chiederle senza violare le regole di Google.

La prova. Ecco la recensione inventata che abbiamo usato: «Siamo venuti sabato mattina con i bambini: venti minuti per due caffè e una granita, e la signora al banco nemmeno ci ha guardato. Peccato, la brioche era buona.» Le risposte qui sotto sono le uscite vere del modello, copiate così come sono. Haiku e Opus 5.5 sono due modelli di Claude.

Come firma il modello ha consigliato «La Direzione».

Guarda le differenze. Senza skill il testo va bene per qualsiasi bar, parte da «Gentile cliente» e promette a nome tuo un discorso con tutta la squadra che nessuno ha deciso. Con la skill è più corto, firmato, riprende i fatti della recensione e ti dice in una riga cosa controllare prima di pubblicare.

E il limite, che non nascondiamo: in tutte e due le risposte con la skill, sia con Haiku sia con Opus 5.5, ci sono insieme il «voi» («vi», «guardarvi») e il «lei» («mi scriva»). Una skill alza il livello, ma la risposta va riletta. Ed è un caso solo su una recensione inventata: non è una statistica.

Quando conviene. La documentazione dà una regola semplice: stai incollando lo stesso prompt o la stessa procedura per la terza volta (panoramica delle funzioni di Claude Code, verificato a novembre 2026). Il messaggio alla cliente che disdice, il riepilogo per chi ti deve pagare, le risposte agli ospiti del B&B. Non conviene per un lavoro che fai una volta sola: lì basta chiederlo in chat.

Cos'è una skill e in cosa è diversa da un prompt salvato, da CLAUDE.md e da un agente

Una skill è una cartella con un file di istruzioni, SKILL.md, che Claude Code usa quando il lavoro lo richiede oppure quando la lanci tu con /nome. Scrivi una volta come si fa un lavoro e non lo rispieghi più (documentazione sulle skill, verificato a novembre 2026). «Skill» resta in inglese perché è il nome ufficiale: in italiano sarebbe «abilità», ma nei menu e nella documentazione non la trovi così.

Nella tabella ci sono le quattro cose che si confondono più spesso, con l'esempio del bar. Le definizioni vengono dalla pagina ufficiale di confronto e da quella sul file CLAUDE.md.

Una riga da ricordare: una regola che deve valere sempre non sta in una skill. Secondo la documentazione, in una skill e anche in CLAUDE.md una regola è una richiesta, non una garanzia. Se qualcosa non deve succedere mai, serve un hook, cioè un comando automatico che scatta a un evento senza che Claude decida. La differenza con gli agenti e il modo di crearne uno li trovi in come creare agenti con Claude Code.

Dove vive una skill e cosa serve per usarla

Il progetto è semplicemente la cartella in cui lavori e da cui apri Claude Code: per Rosa, Bar Da Rosa. La posizione della skill decide dove vale (documentazione sulle skill, verificato a novembre 2026).

Abbiamo provato le due cose che possono sorprenderti, su Windows con Claude Code 2.1.309 collegato a un servizio di prova sul nostro computer, che mostra cosa viene caricato, non come risponde il modello:

• A parità di nome vince la skill personale, come dice la documentazione. Nella prova, con due testi diversi, è stata usata la personale, e Claude Code non ha avvisato di niente.
• Valgono anche le skill delle cartelle superiori. Fuori da un repository git (una cartella tenuta sotto controllo di versione, se non sai cos'è non ne hai uno) una cartella con .claude\skills è stata caricata anche avviando Claude Code in una sottocartella o in una sotto-sottocartella. Dentro un repository, Claude Code si è fermato alla sua radice.

Io tengo 15 skill in una libreria separata e le attivo solo nei progetti dove servono, con uno script. Il perché e lo script ripulito sono nel kit di questa guida, che si scarica dopo la donazione libera. Per iniziare ti basta il progetto.

Cosa serve. Claude Code, con un account a pagamento: qui la pagina ufficiale dei piani (verificato a novembre 2026). Si installa con le istruzioni della pagina ufficiale, e se non vuoi il terminale c'è l'app desktop, quella della nostra prova. Il terminale è la finestra in cui si scrivono i comandi: su Windows è PowerShell, che trovi nel menu Start. Nessun altro abbonamento: una skill è un file di testo. Se il lavoro da mettere nella skill è scrivere, parti da come scrivere contenuti con l'IA senza testi generici: la scheda della tua voce è già metà skill.

Passo 1 a mano: scegli il compito e scrivi il file SKILL.md

Scegli il compito. Prendi un lavoro con queste tre caratteristiche: lo fai spesso, lo fai sempre allo stesso modo, e quando lo chiedi all'IA ripeti le stesse regole. Parti da uno solo, piccolo. Rosa sceglie le recensioni. Una parrucchiera di Bari sceglierebbe il messaggio per chi disdice all'ultimo, un idraulico il riepilogo della giornata.

Scrivi l'intestazione. Il file ha due parti. In alto c'è l'intestazione (in gergo frontmatter), fra due righe di tre trattini. La prima riga del file deve essere proprio ---.

---
name: risposte-recensioni
description: Scrive la risposta del bar Da Rosa a una recensione su Google, TripAdvisor o Facebook. Da usare quando viene incollata una recensione o viene chiesto come rispondere a un cliente.
---

name è il nome del comando: solo minuscole, numeri e trattini, uguale al nome della cartella. Per Claude Code i campi sono facoltativi, per lo standard Agent Skills e per le altre pagine di Anthropic name e description sono obbligatori: scrivili sempre tutti e due e la skill vale ovunque. Le buone pratiche di Anthropic vietano nel nome le parole claude e anthropic. Nella nostra prova Claude Code accetta anche quelle, ma conviene rispettare la regola (verificato a novembre 2026).

La riga più importante è description. È quella che Claude confronta con la tua richiesta per decidere se usare la skill. Dice cosa fa e quando usarla, in terza persona, con le parole che useresti davvero.

Stai sotto i 200 caratteri: è il limite che il centro assistenza di Claude indica per caricarla anche nell'app (come creare una skill, verificato a novembre 2026). Li conti in un attimo con il contatore di parole e caratteri.

Scrivi le istruzioni. Sotto l'intestazione dici cosa fare, non perché: secondo la documentazione ogni riga ha un costo, e il file va tenuto sotto le 500 righe. Tre blocchi bastano quasi sempre: i passi, le regole, il formato del risultato. Il file intero del bar è più sotto, nell'assaggio.

# Risposta a una recensione del bar Da Rosa

La recensione è questa: $ARGUMENTS

Se qui sopra non c'è niente, usa la recensione scritta nella conversazione. Se non c'è nemmeno lì, chiedila e fermati.

$ARGUMENTS diventa quello che scrivi dopo il comando. L'abbiamo controllato: con la recensione dopo il nome, nel testo che arriva al modello c'è «La recensione è questa:» seguito dalla recensione. Se nel testo non c'è $ARGUMENTS, Claude Code aggiunge in fondo quello che hai scritto.

Le trappole del file, provate su Windows con Claude Code 2.1.309. Le prove sul file le abbiamo fatte con il programma vero collegato a un servizio di prova sul nostro computer: mostra cosa viene caricato, non come risponde il modello.

• Una riga vuota prima di ---: l'intestazione non viene letta, e la descrizione diventa ---.
• Il Blocco note può salvare SKILL.md.txt: quel file viene ignorato, senza nessun errore.
• Non creare il file con il simbolo > di PowerShell 5.1: lo salva in UTF-16, una codifica che Claude Code legge male, con descrizione illeggibile e caratteri rotti.
• Il BOM, un segno invisibile che alcuni comandi di Windows aggiungono all'inizio dei file, invece non dà problemi.

Se non vuoi partire dal foglio bianco, fatti scrivere la bozza da una chat qualsiasi, anche gratuita. Il prompt prima ti fa le domande. L'abbiamo provato con il modello Haiku di Claude, su un bar che chiude per un giorno e su una parrucchiera di Bari che risponde a chi disdice. Alla prima prova, sul bar, ha aggiunto di suo una regola sul lunedì e ha scritto la descrizione rivolgendosi all'utente («quando dici…»). Abbiamo corretto e alla seconda ha tenuto il file sotto le 60 righe, lasciato [DA CONTROLLARE] dove mancava un dato e proposto la regola in più a parte, senza metterla nel file.

Leggi il file che ti restituisce, riga per riga, e togli quello che non faresti. Il modello non conosce la tua attività: quello che non gli hai detto o lo chiede, o lo inventa.

Passo 2 a mano: mettila nel progetto, controlla che la veda e usala

Metti il file al suo posto. Crea la cartella del progetto, se non ce l'hai, poi apri PowerShell. Scrivi cd, uno spazio e il percorso del progetto tra virgolette, e lancia le altre righe. Sostituisci il percorso e il nome della skill con i tuoi.

cd "C:\I miei lavori\Bar Da Rosa"
New-Item -ItemType Directory -Force ".claude\skills\risposte-recensioni"
New-Item -ItemType File ".claude\skills\risposte-recensioni\SKILL.md"
notepad ".claude\skills\risposte-recensioni\SKILL.md"

Si apre il Blocco note su un file vuoto che si chiama già nel modo giusto: incolla il testo e salva. Così eviti la trappola di SKILL.md.txt. Le prime tre righe le abbiamo lanciate davvero il 04/11/2026 su Windows 11, in una cartella pulita con uno spazio nel nome; dell'ultima abbiamo provato il risultato, cioè un file salvato come lo salva il Blocco note, non la finestra.

Su Mac e Linux i comandi equivalenti sono questi. Li abbiamo provati solo in Git Bash su Windows, mai su un Mac. Poi apri il file con un editor di testo semplice.

cd "percorso/del/progetto"
mkdir -p ".claude/skills/risposte-recensioni"
touch ".claude/skills/risposte-recensioni/SKILL.md"

Apri Claude Code nel progetto. Dal terminale scrivi claude stando nella cartella del progetto, oppure, nell'app desktop, apri la scheda Code e scegli quella cartella con Open folder. Una sessione è una conversazione con Claude Code, dall'apertura alla chiusura. Se ti chiede se ti fidi della cartella, rispondi sì solo se è tua. Se apri l'app su una cartella più in alto, come nella nostra prova, la skill viene trovata quando apri un file dentro il progetto.

Controlla che la veda. Abbiamo provato questo:

• Dal terminale, nella cartella del progetto: claude plugin validate .claude\skills. Controlla il file e sul nostro ha risposto «Validation passed». Con un'intestazione rotta risponde con l'errore. Va lanciato sulla cartella skills: su una skill singola dice No manifest found in directory, che confonde. Se claude non viene riconosciuto, come sul computer della nostra prova, dove usavamo l'app desktop, salta questo controllo.
• Nell'app desktop: quando si è aperto un file nella cartella, Claude Code ha annunciato da solo la nuova skill, con la sua descrizione.
• Una skill nuova di solito vale subito. Se la cartella .claude\skills non esisteva quando hai aperto la sessione, scrivi /reload-skills. Con il servizio di prova, senza quel comando la skill non si vedeva; con la cartella già esistente si è vista subito.

La documentazione ufficiale indica altri modi: il menu /skills, la domanda What skills are available? (pagina sulle skill) e, nell'app desktop, il segno / nella casella o il pulsante + e poi Slash commands (pagina sull'app desktop), verificato a novembre 2026. Non li abbiamo provati.

Usala, in due modi. Col comando, scrivendo il nome dopo la barra e il testo di seguito: è la forma indicata dalla documentazione, e noi abbiamo controllato il testo che arriva al modello e lo strumento che lancia la skill, non il comando digitato a mano nella finestra.

/risposte-recensioni Venti minuti per due caffè, il sabato. Mai più.

Oppure a parole, senza nominarla. Poi una domanda che non c'entra niente, che non la deve far partire. Ecco cosa è successo nella nostra prova: pochi casi, nessuna statistica. Nessuna descrizione è stata corretta: quella scritta all'inizio è andata bene su queste richieste.

La risposta alla richiesta su Facebook mostra a cosa serve la riga finale. Il fatto del lunedì è inventato come il resto, ma il modello ha capito che non poteva darlo per sicuro:

Prova sempre in una sessione nuova. Quella in cui hai scritto la skill nasconde i buchi, e vedere che parte non vuol dire che lavori bene: la documentazione consiglia di confrontare alcune richieste realistiche con la skill e senza (pagina sulle skill, verificato a novembre 2026). Le richieste di prova fattele scrivere da questo prompt. L'abbiamo provato con il post del giorno del bar: ha trovato da solo il punto debole, cioè che la parola «menù» nella descrizione potrebbe far partire la skill anche per un volantino, e ha proposto una descrizione corretta di 186 caratteri.

Se non parte, il problema di solito è la descrizione: aggiungi le parole che hai usato nella richiesta e riprova. Se parte quando non deve, rendila più precisa. Se parte una versione vecchia, controlla di non avere una skill personale con lo stesso nome.

Per toglierla cancella la sua cartella e apri una sessione nuova. La documentazione dice che la skill esce subito dall'elenco, e con il servizio di prova, su una sessione aperta direttamente sul progetto, è andata così quando la cartella .claude\skills c'era già all'avvio; se non c'era, è servito di nuovo /reload-skills. Nella prova con il modello vero, però, una sessione aperta su una cartella più in alto ha continuato a offrirla e a lanciarla a memoria, anche con i file già cancellati. In una sessione nuova, controllata con il servizio di prova, non c'era più. Tutto questo è provato su Windows; su Mac e Linux non l'abbiamo visto.

L'assaggio del kit: la skill del bar Da Rosa, intera

Questo è il file vero del kit, così com'è. Va in .claude/skills/risposte-recensioni/SKILL.md. Nel kit c'è accanto tono-ed-esempi.md, con il tono ed esempi di risposta: se copi solo questo file, togli il passo 1 oppure scrivi il tuo. Il bar «Da Rosa», i suoi dati e l'indirizzo sono inventati: sostituiscili con i tuoi.

A mano una skill sta in un progetto solo e, se ti serve altrove, la ricopi e perdi il conto delle versioni. Con lo script del kit tieni tutto in una libreria e con un comando attivi, togli e vedi cosa è acceso in ogni progetto. Lo script avvisa anche degli errori che Claude Code non segnala da solo: file in codifica sbagliata, prima riga fuori posto, skill personale omonima che vince, skill che arrivano dalle cartelle superiori.

Parti da tre skill di tipo diverso e da un modello commentato, invece che da un foglio bianco. C'è anche la tabella delle skill di altri, con link e licenza controllati il 04/11/2026. Tutto è testo, quindi puoi leggere ogni file prima di usarlo. Lo script funziona su Windows; su Mac e Linux si usano i comandi a mano qui sopra. Il riquadro qui sotto elenca il contenuto e quanto pesa: il kit si scarica dopo la donazione libera.

Domande frequenti sulle skill di Claude Code

Cosa sono le skill di Claude?

Una skill è una cartella con un file di istruzioni, SKILL.md, che dice a Claude come fare un lavoro preciso. Claude Code la usa da solo quando la richiesta c'entra, oppure la lanci tu con /nome. A differenza di un prompt, non devi incollarla ogni volta: la scrivi una volta sola e resta lì. Il formato è uno standard aperto che si chiama Agent Skills.

Come creare una skill su Claude senza Claude Code?

Nell'app Claude si carica come file ZIP: prepari la cartella con SKILL.md, la comprimi tenendola come radice dello ZIP, poi vai in Customize, Skills, il pulsante +, Create skill e Upload a skill, con l'esecuzione del codice attiva. Lo dice il centro assistenza di Claude, verificato a novembre 2026. Questa strada non l'abbiamo provata. Una skill caricata nell'app non passa da sola in Claude Code, e viceversa.

Le skill di Claude sono gratis?

Il formato sì: una skill è un file di testo che scrivi tu. Claude Code invece non è nel piano gratuito di claude.ai. Per l'app Claude le pagine ufficiali non concordano: il centro assistenza indica le skill anche sul piano gratuito, una pagina per sviluppatori solo sui piani a pagamento, quindi controlla sul tuo account. Verificato a novembre 2026.

Che differenza c'è tra skill e agente in Claude Code?

La skill è un insieme di istruzioni che Claude segue dentro la conversazione in corso. L'agente, che la documentazione chiama subagente, è un lavoratore separato: fa il compito a parte, non vede la tua conversazione e alla fine ti restituisce un riassunto. Usa la skill per dire come si fa un lavoro, l'agente per affidare un lavoro lungo da tenere fuori dalla conversazione. Per crearne uno c'è la guida su come creare agenti con Claude Code.

Meglio una skill o il file CLAUDE.md?

Dipende da quando serve. CLAUDE.md viene letto per intero a ogni sessione: ci stanno poche regole che valgono sempre, e la documentazione consiglia di restare sotto le 200 righe. La skill si carica solo quando serve: ci stanno le procedure e i lavori che fai ogni tanto. Se una procedura a più passi è finita in CLAUDE.md, conviene spostarla in una skill.

Posso attivare una skill solo in un progetto?

Sì: la metti nella cartella .claude/skills di quel progetto e vale lì. Ci sono due eccezioni, che abbiamo provato su Windows con Claude Code 2.1.309. Se hai una skill personale con lo stesso nome vince quella, senza nessun avviso. E Claude Code carica anche le skill delle cartelle superiori: dentro un repository git si ferma alla sua radice, fuori da git risale le cartelle sopra il progetto.

Le fonti delle risposte: le skill nell'app Claude, la pagina per sviluppatori, lo standard Agent Skills, i subagenti, tutte aperte a novembre 2026.

Da fare oggi: pensa all'ultima regola che hai ripetuto a un'IA per la terza volta e scrivila in tre righe: cosa fare, cosa non fare mai, come vuoi il risultato. Poi incollala nel prompt del passo 1. Se ti blocchi, scrivi a Fabio: raccontagli il lavoro che vuoi trasformare e incolla il file che è uscito.