Skills in Claude Code: installarne uno e creare il proprio

Se chiedi spesso a Claude Code di rivedere un modulo, descrivere delle modifiche o analizzare un errore di build, ognuno di questi compiti finisce per avere un suo ordine: leggere i file che servono, verificare le condizioni, restituire il risultato in forma chiara. Quell'ordine conviene scriverlo una volta sola, in uno skill.

Uno Skill è una cartella con le istruzioni nel file SKILL.md e, se servono, materiali aggiuntivi. L'agente ci trova una procedura ripetibile insieme ai suoi esempi e ai file di supporto. Il formato è descritto nella specifica Agent Skills.

• specifica Agent Skills

La guida spiega l'installazione in Claude Code in locale e costruisce uno skill di esempio per rivedere un modulo di contatto. I comandi sono stati verificati sulla documentazione il 3 ottobre 2026. L'esempio è didattico e non è il resoconto di una prova su un sito reale.

Quale procedura scegliere

Scegli una procedura che sai già spiegare a parole: «Prima della consegna, esamina i campi obbligatori, i messaggi di errore e l'invio del modulo, poi elenca i problemi».

Per un primo skill funziona meglio di un generico «crea siti di qualità». La revisione di un modulo ha dati in ingresso, passaggi e un risultato che si può valutare.

Parti da una sola riga della tabella. Uno skill che sviluppa il sito, scrive la pubblicità, configura il server e pubblica il tutto è difficile da correggere, perché non si capisce quale fase abbia sbagliato.

Installare da una cartella

Gli skill personali stanno in `~/.claude/skills/`, quelli del progetto in `.claude/skills/` dentro il repository. Ogni skill ha la sua cartella con un SKILL.md. Quello personale è disponibile in tutti i progetti della macchina, quello di progetto viaggia insieme al codice.

• Posizioni

project/
└── .claude/
    └── skills/
        └── form-review/
            ├── SKILL.md
            └── references/
                └── checklist.md

Se hai scaricato una raccolta, trova la cartella dello skill che ti interessa e copiala per intero. Copiando il solo SKILL.md rischi di spezzare i riferimenti ai materiali allegati.

Controlla l'albero delle cartelle che ottieni. Decomprimendo un archivio capita spesso di ritrovarsi un livello in più:

.claude/skills/form-review/form-review/SKILL.md

Nel nostro esempio il file deve stare un livello più su:

.claude/skills/form-review/SKILL.md

Prima di copiare, guarda se esiste già una cartella con quel nome. Se c'è, confronta prima le versioni, per non sovrascrivere le tue modifiche.

Installare tramite plugin

Se l'autore distribuisce gli skill come plugin, segui le sue istruzioni di installazione. Per il repository ufficiale di Anthropic i comandi sono questi, da digitare dentro Claude Code:

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

Il primo comando aggiunge il marketplace, il secondo installa gli esempi. Per il lavoro sui documenti lo stesso repository propone `document-skills@anthropic-agent-skills`.

• README ufficiale

Cartella e plugin sono due modi diversi di distribuire uno skill. Un SKILL.md isolato trovato su GitHub non si installa con `/plugin install`: verifica prima che l'autore offra un pacchetto in un marketplace.

`/plugin install` apre la scheda del plugin, dove scegli l'ambito: per te in tutti i progetti, per chiunque lavori sul repository, oppure solo per te in quel repository. Poi leggi il riepilogo dell'installazione. Se serve un ricaricamento, di norma Claude Code esegue `/reload-plugins` da solo. Se il plugin non è stato caricato, il motivo è nella scheda Errors di `/plugin`.

• Installazione

Controllare uno skill altrui

Prima del primo avvio leggi SKILL.md e gli script allegati, e confrontali con il compito. Se lo skill serve a rivedere un modulo e intanto invia il contenuto del repository a un server esterno, la cosa richiede una spiegazione.

Annota da dove viene lo skill, quale versione usi e che cosa hai cambiato. Se un aggiornamento modifica il risultato, avrai un termine di confronto.

Guarda anche che cosa l'autore dà per scontato. Può aver scritto lo skill per un framework, un insieme di comandi o uno strumento del browser che nel tuo progetto non ci sono. Quelle parti vanno sostituite con le tue. Nessuno skill «funziona ovunque».

Creare lo skill di revisione

Il nostro skill legge l'implementazione del modulo e scrive un rapporto. Non corregge il codice e non invia richieste: così la ricerca del problema resta separata dalla correzione.

Crea la cartella `.claude/skills/form-review/` dall'editor. Su macOS, Linux o WSL puoi usare il terminale:

mkdir -p .claude/skills/form-review

Poi crea al suo interno SKILL.md con il contenuto qui sotto. È un esempio didattico, da adattare al tuo progetto.

---
name: form-review
description: Esamina un modulo di contatto e riporta problemi di validazione, messaggi e invio. Usalo per la revisione prima del rilascio.
disable-model-invocation: true
---

# Revisione del modulo

## Obiettivo
Trovare errori di implementazione e verifiche ancora necessarie.
Leggi soltanto i file. Non modificare codice, non inviare
il modulo e non contattare servizi esterni.

## Input
Serve il percorso del modulo o il nome del percorso utente.
Se corrispondono più moduli, chiedi quale esaminare.

## Procedura
1. Leggi componente, gestore e test collegati.
2. Individua campi obbligatori e regole di validazione.
3. Controlla nel codice input vuoto ed email non valida.
4. Segui gli stati di invio, successo ed errore.
5. Verifica la gestione esplicita dei clic ripetuti durante l'invio;
   se non è chiara, descrivi l'incertezza.
6. Confronta conclusioni e test. Un test presente non è
   necessariamente stato eseguito o superato.

## Resoconto
Per ogni problema indica:
- file e posizione;
- condizione che lo provoca;
- possibile conseguenza per l'utente;
- verifica o correzione proposta.

Elenca separatamente ciò che richiede l'esecuzione dell'applicazione.
Se non trovi problemi evidenti, dichiaralo senza affermare
che il modulo sia stato verificato completamente.

In cima al file, tra le righe `---`, ci sono i metadati; sotto viene la procedura. La specifica aperta Agent Skills richiede `name` e `description`, e il nome deve coincidere con quello della cartella. Claude Code è più permissivo: tutti i campi sono facoltativi e solo `description` è consigliato. Nel nome sono ammesse lettere latine minuscole, cifre e trattini.

• Formato

`disable-model-invocation: true` è un'impostazione di Claude Code: lo skill parte solo quando lo richiami tu, e Claude non lo carica di sua iniziativa. Qui serve a far cominciare la revisione sempre con un comando esplicito. L'indicazione di sola lettura descrive un comportamento. I permessi tecnici si configurano a parte.

• Invocazione
• permessi

Invocare e valutare

Apri il progetto in Claude Code e digita:

/form-review Esamina il modulo in src/components/LeadForm.tsx

Il percorso è solo un esempio: indica un file che esiste nel tuo progetto. Uno skill si richiama direttamente con `/nome-skill`.

• Invocare Skills

Per mettere alla prova lo skill, scegli un modulo con un difetto che conosci già. Per esempio, il messaggio di errore dell'invio sparisce appena si preme di nuovo il pulsante. Guarda se l'agente nota proprio questo comportamento e se ne mostra la causa nel codice.

Valuta il rapporto su quattro punti:

1. Cita file che esistono e punti precisi dell'implementazione.
2. Ogni rilievo indica la condizione in cui il problema si presenta.
3. Le ipotesi sono tenute separate dalle conclusioni sostenute dal codice.
4. Aver letto i test non viene presentato come averli eseguiti con successo.

Se invece ricevi un lungo elenco di consigli generici, rendi più severa la richiesta di prove. Aggiungi per esempio: «Non inserire raccomandazioni senza mostrare l'implementazione collegata». Poi ripeti la revisione sullo stesso modulo.

Cambia una sola parte importante delle istruzioni alla volta, altrimenti non saprai quale modifica ha reso la risposta più utile. Questo è un metodo di lavoro redazionale. Qui non si riportano risultati di test dello skill.

Descrivere la selezione automatica

Se lo skill deve essere scelto in automatico, descrivi sia che cosa fa sia quando va usato. Confronta:

Aiuta a sviluppare applicazioni.

E una versione più precisa:

Esamina moduli prima del rilascio: validazione, errori e stati di invio. Usalo per revisioni del modulo, non per analisi generali dell'architettura.

La seconda versione mette dei confini, e l'agente ha meno motivi per scegliere lo skill in un compito che non c'entra. Anche la specifica raccomanda di scrivere in `description` che cosa fa lo skill e quando serve.

• Campo description

Nel nostro esempio la selezione automatica è disattivata. Se la abiliti, prova la descrizione con più richieste: una adatta, una vicina e una chiaramente estranea. Guardare che cosa succede dice più che giudicare la formulazione a orecchio.

Se non appare o non parte

Controlla prima il percorso, il nome esatto del file SKILL.md e l'inizio del blocco YAML: la riga `---` deve essere la prima. Claude Code rileva durante la sessione le modifiche fatte nelle cartelle di skill già esistenti. Se hai creato la cartella principale `.claude/skills/` dopo l'avvio della sessione, esegui `/reload-skills`.

• Modifica e caricamento

Poi distingui due situazioni. Se lo skill non si trova quando lo richiami direttamente, controlla l'installazione. Se a mano funziona ma l'agente non lo sceglie mai da solo, controlla la modalità di invocazione e la descrizione.

Quando uno skill personale e uno di progetto hanno lo stesso nome, Claude Code esegue quello personale. Se il risultato ti sorprende, guarda in entrambe le cartelle.

• Conflitti di nomi