Skills in Claude Code: installarne uno e creare il proprio
Neaptide · 20 settembre 2026 · 8 min di lettura
Installa Skills da cartelle o plugin, scrivi SKILL.md e valuta il risultato con un esempio di revisione di un modulo.
In questo articolo
Le attività ripetute assumono un ordine abituale: leggere i file, verificare condizioni e restituire un risultato chiaro. Se chiedi spesso revisioni di moduli, descrizioni delle modifiche o analisi di errori di build, puoi trasformare la procedura in uno skill.
Uno Skill è una cartella con istruzioni in SKILL.md ed eventuali materiali aggiuntivi. Riunisce procedura ripetibile, esempi e file ausiliari. Vedi la specifica Agent Skills.
La guida riguarda Claude Code locale e una revisione didattica di un modulo. I comandi sono stati confrontati con la documentazione; l'esempio non è il resoconto di una prova su un sito reale.
Quale procedura scegliere
Scegli un compito che sai spiegare: «Prima della consegna, esamina campi obbligatori, errori e invio del modulo, poi elenca i problemi».
È più facile da valutare rispetto a «crea siti di qualità»: ha input, passaggi e risultato.
| Compito | Che cosa conservare | Risultato |
|---|---|---|
| Revisione modulo | Scenari e ordine dei controlli | Problemi e condizioni non verificate |
| Descrizione modifiche | Struttura e selezione dei dettagli | Bozza coerente con il diff |
| Errore di build | Lettura dei log e diagnosi | Causa fondata o ipotesi residue |
| Preparazione articolo | Criteri editoriali e link | Correzioni concrete |
Parti da una riga. Uno skill che sviluppa, scrive pubblicità, configura server e pubblica sarà difficile da migliorare.
Installare da una cartella
Gli skills personali vanno in `~/.claude/skills/`; quelli del progetto in `.claude/skills/`. Ciascuno ha cartella e SKILL.md. I personali funzionano in più progetti della macchina; gli altri si conservano con il codice. Posizioni.
project/
└── .claude/
└── skills/
└── form-review/
├── SKILL.md
└── references/
└── checklist.mdIn una raccolta scaricata, trova lo skill e copia l'intera cartella. Il solo SKILL.md potrebbe perdere riferimenti ai materiali.
Evita un livello duplicato:
.claude/skills/form-review/form-review/SKILL.mdIl percorso corretto dell'esempio è:
.claude/skills/form-review/SKILL.mdSe esiste già, confronta le versioni prima di copiare per non perdere modifiche personali.
Installare tramite plugin
Segui l'autore se distribuisce un plugin. Per il repository ufficiale Anthropic, digita dentro Claude Code:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skillsIl primo comando aggiunge il marketplace, il secondo installa gli esempi. Per i documenti è indicato anche `document-skills@anthropic-agent-skills`. README ufficiale.
Cartella e plugin sono distribuzioni diverse. Un SKILL.md isolato su GitHub non è automaticamente un pacchetto installabile: verifica l'esistenza del marketplace.
Leggi il messaggio finale. Se serve attivazione, esegui `/reload-plugins`; gli errori sono in `/plugin`. L'ambito determina se il plugin è personale, condiviso con il progetto o locale per te nel progetto. Installazione.
Controllare uno skill altrui
Leggi SKILL.md e script prima di avviare. Confronta il comportamento con il bisogno: una revisione di modulo non giustifica senza spiegazioni l'invio del repository a un server esterno.
Annota origine, versione e modifiche personali. Potrai confrontarle se un aggiornamento cambia l'esito.
Verifica i prerequisiti: framework, comandi e strumenti browser dati per scontati possono mancare. Adatta le ipotesi invece di promettere compatibilità universale.
Creare lo skill di revisione
L'esempio legge l'implementazione e produce un rapporto. Non corregge codice né invia richieste, separando diagnosi e intervento.
Crea `.claude/skills/form-review/` nell'editor oppure, su macOS, Linux o WSL:
mkdir -p .claude/skills/form-reviewInserisci in SKILL.md questo esempio didattico e adattalo:
---
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.I metadati sono tra le righe `---`, poi viene la procedura. La specifica richiede `name` e `description`; il nome corrisponde alla cartella. Qui usa lettere latine minuscole e trattino. Formato.
`disable-model-invocation: true` è l'impostazione Claude Code per l'invocazione manuale, scelta per rendere esplicito l'avvio. La sola lettura è una regola di comportamento; i permessi tecnici sono separati. Invocazione, permessi.
Invocare e valutare
Nel progetto aperto con Claude Code:
/form-review Esamina il modulo in src/components/LeadForm.tsxSostituisci il percorso illustrativo con un file esistente. L'invocazione diretta è `/nome-skill`. Invocare Skills.
Scegli un modulo con un comportamento noto, per esempio un errore che scompare dopo un altro clic. Verifica se l'agente lo nota e ne mostra la causa nel codice.
Valuta quattro aspetti:
- File esistenti e posizioni precise.
- Condizione di comparsa per ogni rilievo.
- Ipotesi separate dalle conclusioni sostenute dal codice.
- Lettura dei test distinta dalla loro esecuzione riuscita.
Se ricevi consigli generici, rafforza la prova: «Non inserire raccomandazioni senza mostrare l'implementazione collegata». Ripeti sullo stesso modulo.
Cambia una parte importante alla volta per capire che cosa migliora l'esito. È un metodo proposto, non il resoconto di test effettuati.
Descrivere la selezione automatica
Indica azione e occasione. Confronta:
Aiuta a sviluppare applicazioni.
Con:
Esamina moduli prima del rilascio: validazione, errori e stati di invio. Usalo per revisioni del modulo, non per analisi generali dell'architettura.
Il secondo delimita meglio lo scopo. La specifica raccomanda di descrivere che cosa fa e quando serve. Campo description.
Nell'esempio la selezione automatica è disattivata. Se la abiliti, prova una richiesta adatta, una vicina e una estranea. Osservare è più utile che giudicare soltanto la formulazione.
Se non appare o non parte
Controlla percorso, nome SKILL.md e apertura YAML: `---` deve essere la prima riga. Se hai creato `.claude/skills/` dopo l'avvio della sessione, riavvia Claude Code. Modifica e caricamento.
Distingui installazione e selezione. Se fallisce l'invocazione diretta, controlla l'installazione; se funziona ma non viene scelto automaticamente, controlla modalità e descrizione.
A parità di nome, Claude Code preferisce lo skill personale a quello del progetto. Esamina entrambe le cartelle in caso di sorpresa. Conflitti di nomi.