Skill di Claude Code: che cosa sono e come se ne crea una

A che cosa serve una skill, rispetto al CLAUDE.md?

Il CLAUDE.md è ciò che deve valere sempre; una skill è ciò che serve solo in certi momenti. La differenza si paga in contesto: il primo è caricato a ogni sessione, della seconda all’avvio entra solo la descrizione.

Hai	Mettila in
Una regola che vale per ogni modifica	CLAUDE.md
Una procedura con passaggi, usata ogni tanto	Skill
Un lavoro che produce molto testo da riassumere	Sotto-agente
Un controllo che deve scattare comunque	Hook

Esempi per chi vende online: il controllo settimanale del feed, la preparazione di un file per Merchant Center, il rapporto sui prodotti senza costo. Lavori che seguono sempre gli stessi passi, e in cui dimenticarne uno costa caro.

Ricontrollato l’8 novembre 2026 su Claude Code 2.1.319.

Come si crea una skill, passo per passo?

Bastano una cartella e un file. Una skill personale vale in tutti i progetti; una di progetto sta nel repository e arriva a chi ci lavora.

Dove	Vale per
~/.claude/skills/nome/SKILL.md	Te, in tutti i progetti
.claude/skills/nome/SKILL.md	Chi lavora a quel progetto

Un esempio inventato:

---
name: controllo-feed
description: Controlla il feed del catalogo prima del caricamento su Merchant Center. Usala quando si parla di feed, titoli troppo lunghi o prodotti senza GTIN.
---

1. Leggi il file in input/ e conta i prodotti.
2. Segnala titoli oltre 150 caratteri, ID doppi e prezzi vuoti.
3. Scrivi l'elenco in output/controllo.csv.
4. Non modificare il file di partenza.

L’intestazione fra i due — va all’inizio esatto del file: se la prima riga è un’altra, Claude Code la tratta come testo normale. Il nome del comando viene da name, o dalla cartella se manca. Una skill si può poi richiamare con /controllo-feed, e nella stessa cartella possono stare file di esempio o script.

Come si scrive una description che fa partire la skill?

Dicendo che cosa fa e quando usarla, con le parole che useresti davvero. Claude sceglie leggendo solo quel testo, quindi una description vaga equivale a una skill che non parte.

Debole	Buona
Aiuta con il feed	Controlla il feed del catalogo prima del caricamento su Merchant Center. Usala quando si parla di feed, titoli lunghi o GTIN
Report	Prepara il rapporto settimanale dei prodotti con margine negativo dal file di vendite

Conviene mettere davanti l’uso principale. Description e when_to_use, insieme, vengono tagliate a 1.536 caratteri nell’elenco, e con molte skill lo spazio complessivo può non bastare per tutte. Se la description manca, Claude usa la prima riga non vuota del testo, che di rado dice quando servirebbe.

Se una skill compie azioni che non vuoi partano da sole, come caricare un file, c’è il campo disable-model-invocation: true: parte solo quando la scrivi tu. Il contrario è user-invocable: false, per ciò che deve usare solo Claude.

Quali altri campi conviene conoscere?

Pochi bastano per quasi tutto. Questi sono quelli che risolvono i problemi più comuni.

Campo	A che cosa serve
allowed-tools	Strumenti che la skill può usare senza chiedere conferma, durante quel turno
context: fork	Fa lavorare la skill in un contesto separato, così il testo prodotto non riempie la conversazione
model ed effort	Scelgono modello e impegno quando la skill è attiva
shell	Con quale terminale girano i comandi inseriti nella skill: bash o powershell

Una skill con allowed-tools concede dei permessi: leggi quelle che installi da altri prima di usarle, come faresti con uno script. Una skill è fatta di istruzioni che il modello esegue, e può contenere comandi.

Per controllare quanto pesano le skill che hai, c’è /skills; /skill-doctor mostra anche quanto vengono usate, ma dipende da una funzione che Anthropic attiva a distanza e può non comparire. Il peso delle skill si legge insieme al resto nella guida su modelli, contesto e costi.

Perché una skill non parte?

Di solito per la description, o perché non è stata trovata. Conviene controllare in quest’ordine.

1. Compare in /skills? Se no, il file è nel posto sbagliato o la cartella non è quella in cui hai aperto Claude. Una cartella creata a sessione aperta può richiedere /reload-skills.
2. Parte con /nome? Se sì, la skill è sana: il problema è la description, che non corrisponde a come chiedi le cose.
3. Ha disable-model-invocation? In quel caso è voluto: parte solo a mano.
4. L’intestazione è valida? Un errore nell’intestazione la fa caricare senza campi: niente description, quindi nessuna scelta automatica.

Altri casi sono nella guida agli errori comuni. Quando la procedura da seguire è una richiesta che ripeti, il punto di partenza è la guida su come chiedere bene a Claude Code: una buona skill è una buona richiesta che hai deciso di non riscrivere più.

Una procedura può anche fare da regista per più agenti, ma la skill resta un testo: se i numeri che produce finiscono in una decisione, vanno ricontrollati. Come dare a Claude i dati di un negozio, e fino a dove fidarsi, è spiegato nella pagina su Claude per e-commerce.

Domande frequenti

Fonti

• Claude Code: Skills
• Claude Code: Commands