I Skill di Claude Code sono cartelle contenenti un file SKILL.md che Claude Code carica su richiesta quando un'attività corrisponde alla descrizione dello Skill. Inserisci la cartella in .claude/skills/ nel tuo progetto (oppure in ~/.claude/skills/ per renderla disponibile in ogni progetto); Claude Code legge il frontmatter e, da quel momento, recupera le istruzioni ogni volta che sono pertinenti. Di seguito: dove risiedono, in cosa differiscono da CLAUDE.md, dai comandi slash e da MCP, una procedura d'installazione in 3 passaggi e 15 Skill per sviluppatori che oggi funzionano in Claude Code.
Cos'è effettivamente uno Skill di Claude Code
Uno Skill è una directory con un file obbligatorio, SKILL.md, e facoltativamente alcuni file di supporto (documenti di riferimento, template, piccoli script). SKILL.md inizia con un frontmatter YAML che contiene due campi importanti per Claude Code: nome e description. Sotto il frontmatter c'è Markdown semplice: il ruolo, il processo, il formato dell'output, le regole.
La decisione progettuale più importante è che i Skill vengono caricati in modo lazy. Claude Code mantiene nel contesto un breve indice del nome e della descrizione di ogni Skill installato. Quando la tua richiesta sembra corrispondere, legge l'SKILL.md completo e lo segue. Quando non corrisponde, lo Skill ti costa quasi nulla. Ecco perché una descrizione ben scritta conta più di qualsiasi altra cosa nel file: è l'unica cosa che Claude Code vede prima di decidere se aprire lo Skill.
Lo stesso SKILL.md che ottieni quando acquisti un Skill su KissMySkills: un file .md più un README, identico a quello che caricheresti in un Claude Project, in un GPT personalizzato o in una Gemini Gem.
Dove risiedono i Skill: a livello di progetto o a livello utente
Claude Code cerca in due posizioni.
-
A livello di progetto:
<repo>/.claude/skills/<skill-name>/SKILL.md. Inserisci questa cartella nel commit e ogni membro del team che clona il repository ottiene il Skill. Usalo per tutto ciò che è legato a questo codebase: la tua checklist per le revisioni, la procedura operativa per il deployment, lo stile della documentazione della tua API. -
A livello utente:
~/.claude/skills/<skill-name>/SKILL.md. Disponibile in ogni progetto sul tuo computer, invisibile ai membri del team. Usalo per le tue abitudini personali: come preferisci scrivere i messaggi di commit, la struttura dei test che preferisci, una persona che usi con tutti i clienti.
Se esiste una skill con lo stesso nome in entrambe le posizioni, prevale la copia a livello di progetto. Mantieni le skill generali per sviluppatori a livello utente e quelle con regole specifiche del progetto a livello di progetto.
Come Claude Code scopre una skill
La scoperta è determinata dal description campo nel frontmatter, non dal nome del file né dal nome della cartella. Una descrizione come "Revisione del codice per le pull request" è debole perché si attiva solo quando dici letteralmente "revisione". Una descrizione come "Esamina differenze, pull request e file modificati alla ricerca di bug, problemi di sicurezza, test mancanti e nomi poco chiari. Usa questa skill ogni volta che l'utente chiede di controllare, revisionare, sottoporre ad audit o criticare il codice" si attiva con le formulazioni che gli sviluppatori usano davvero.
Tre cose da sapere:
- Le skill vengono indicizzate all'avvio di una sessione. Se aggiungi una cartella durante la sessione, avvia una nuova sessione o chiedi a Claude Code di rileggere le sue skill.
- La descrizione dovrebbe indicare quando usare la skill, non solo che cos'è. Le frasi di attivazione vanno inserite lì.
- Puoi sempre forzare una skill nominandola: "usa la skill di revisione del codice su questa differenza". La scoperta automatica è una comodità, non l'unico modo.
Skills vs CLAUDE.md vs comandi slash vs server MCP
Questi quattro elementi vengono continuamente confusi, ma risolvono problemi diversi.
| Meccanismo | Che cos'è | Quando viene caricato | Ideale per |
|---|---|---|---|
| CLAUDE.md | File di memoria del progetto nella root del repository (o ~/.claude/CLAUDE.md) | Sempre, a ogni turno | Informazioni che Claude non deve mai dimenticare: stack, convenzioni, comandi, aree da non toccare |
| Skill | Cartella con SKILL.md e file di supporto opzionali | Su richiesta, quando la descrizione corrisponde | Procedure esperte che ti servono occasionalmente: revisioni, audit, piani di test, runbook |
| Comando slash | File Markdown in .claude/commands/, eseguito con /name | Solo quando digiti il comando | Azioni ripetibili che attivi deliberatamente: /deploy-checklist, /write-pr |
| Server MCP | Processo esterno che espone strumenti (database, API, browser) | Gli strumenti sono disponibili per tutta la sessione | Dare a Claude la capacità di fare qualcosa, non la conoscenza di come farlo bene |
La versione breve: CLAUDE.md è un contesto sempre attivo, una skill è una competenza che arriva quando serve, un comando slash è un pulsante che premi e un server MCP è un paio di mani. Una buona configurazione usa tutti e quattro: MCP perché Claude possa agire, una skill perché agisca come un ingegnere senior.
Una conseguenza: non incollare una checklist di revisione di 2.000 parole in CLAUDE.md. Sarà nel contesto quando rinomini una variabile. Trasformala in una skill.
Installa una skill di Claude Code in 3 passaggi
Passaggio 1: ottieni SKILL.md. Scarica il file .md dal tuo ordine KissMySkills (oppure scrivine uno tu). Se il file non si chiama già SKILL.md, rinominalo. Il frontmatter deve contenere almeno name: e description:; ogni competenza venduta sul marketplace viene fornita con entrambi.
Passaggio 2: crea la cartella. Dalla radice del repository:
mkdir -p .claude/skills/code-reviewer
mv ~/Downloads/yuri-code-reviewer.md .claude/skills/code-reviewer/SKILL.mdPer un'installazione a livello utente, sostituisci .claude/skills per ~/.claude/skills. Il nome della cartella dovrebbe corrispondere al nome nel campo del frontmatter, in minuscolo e con trattini.
Passaggio 3: avvia una nuova sessione di Claude Code in quella directory e chiedi qualcosa che rientri nella descrizione. Dovresti vedere la struttura della competenza nella risposta (le sezioni della revisione, le etichette di gravità o qualunque elemento definito dalla competenza). Nessun file di configurazione, né altro da riavviare.
Se vuoi una guida più dettagliata, con schermate e l'equivalente per Claude.ai, leggi come installare una competenza di Claude.
Come testare una competenza
Testare richiede cinque minuti.
- Test di attivazione. Fai tre richieste che dovrebbero attivare la competenza usando formulazioni diverse ("esamina questo", "c'è qualcosa che non va in questa funzione?", "controlla la pull request"). Se una non funziona, amplia la descrizione con quella formulazione.
- Test negativo. Fai una richiesta adiacente che non dovrebbe attivarla ("rinomina questa variabile"). Se la competenza viene comunque caricata, la descrizione è troppo ampia.
- Test dell'output. Confronta la risposta con ciò che SKILL.md promette. Se la competenza dice "elenca sempre la gravità per ogni risultato" e nell'output non compare alcun livello di gravità, le istruzioni vengono lette ma non seguite; rendile più brevi e precise.
- Test esplicito. Indica direttamente la competenza. Se funziona e il rilevamento automatico no, il problema è al 100% nella descrizione.
Per vedere com'è fatto un file SKILL.md ben realizzato prima di scriverne o acquistarne uno, qui vengono spiegati riga per riga 12 veri file SKILL.md.
15 competenze di Claude Code per sviluppatori
Tutto ciò che segue proviene dalla raccolta di competenze per Claude Code. Ciascuna è un acquisto una tantum, con un file di competenza .md più il README, e coperta dalla politica di rimborso entro 30 giorni. I prezzi sono corretti al momento della stesura.
Qualità del codice
Yuri - Code Reviewer AI Skill ($19): esegue una revisione strutturata su qualsiasi diff, file o PR, raggruppando i risultati per gravità.
Soren - Code Auditor AI Skill ($19): analizza un'intera codebase anziché una singola modifica, cercando debito strutturale, codice morto, pattern incoerenti e aree ad alto rischio. Ideale per la prima settimana di lavoro su un repository ereditato.
Albert - AI Code Review Agent ($39): un agent di revisione ottimizzato per cicli rapidi, con particolare attenzione alla correttezza e ai casi limite nelle righe modificate.
Mira - QA Engineer AI Skill ($19): trasforma la descrizione di una funzionalità o un diff in casi di test, casi limite e un piano di test, quindi scrive i test nel tuo framework. Utile quando chiedi a Claude Code di "aggiungere test" e vuoi qualcosa in più del semplice percorso positivo.
Distribuzione
Rami - DevOps Engineer AI Skill ($19): pipeline CI/CD, Dockerfile, infrastruttura come codice e procedure operative per gli incidenti, con la prudenza di un vero ingegnere DevOps. Chiede informazioni sul rollback prima di scrivere un passaggio di deploy.
Max - Full Stack Developer AI Skill ($19): il generalista: crea lo scheletro delle funzionalità tra API, livello dati e UI, mantenendo coerenti i vari elementi. Se installi una sola Skill per la distribuzione, scegli questa.
Lena - Frontend Developer AI Skill ($19): struttura dei componenti, stato, accessibilità e comportamento responsive per gli stack frontend moderni. Impedisce a Claude Code di distribuire una zuppa di div con stili inline.
Niko - Backend Developer AI Skill ($19): progettazione delle API, modellazione dei dati, gestione degli errori e prestazioni per il codice lato server. Eccellente per gli aspetti noiosi (validazione, paginazione, idempotenza) che i prompts generici trascurano.
Elena - Skill AI per Data Engineer ($19): pipeline, schemi, trasformazioni e controlli della qualità dei dati. Usala quando l'attività riguarda lo spostamento dei dati anziché la loro pubblicazione.
Documentazione e processi
Saoirse - Skill AI per Technical Writer ($19): README, descrizioni delle PR, changelog, note sull'architettura e documentazione per l'onboarding con una voce coerente. Chiedi a Claude Code di "scrivere la descrizione della PR" dopo averlo installato e otterrai contesto, modifiche, test e rischi, non una sola riga.
Dorian - Agente AI per la documentazione delle API ($39): genera e mantiene la documentazione di riferimento delle API a partire dal codice: endpoint, parametri, esempi e risposte agli errori. Indicalo a un file del router e lascia che colmi le lacune.
Verity - Skill AI per Release Engineering & Build Systems Engineer ($19): versioning, note di rilascio, convenzioni per i messaggi di commit, configurazione delle build e riproducibilità. La Skill da installare se nel tuo team si discute sui Conventional Commits.
Sicurezza
Anaya - Skill AI per Application Security Engineer ($19): analizza il codice alla ricerca di injection, falle di autenticazione, gestione dei secret e rischi legati alle dipendenze, spiegando come risolverli anziché limitarsi a segnalare il problema. Eseguila prima di una release, non dopo.
Selwyn - Skill Claude per Penetration Tester ($19): ragiona come un attaccante contro la tua stessa applicazione: modelli delle minacce, percorsi d'attacco e un elenco prioritario di cosa testare.
Cassandra - Skill Claude per Vulnerability Management Engineer ($19): analisi dell'output degli scanner e degli elenchi CVE: cosa conta, cosa è rumore e cosa applicare per prima. Affiancala a un audit delle dipendenze nella tua CI.
Non sai da quale iniziare? La pagina del marketplace delle Skill di Claude organizza l'intero catalogo per ruolo, mentre la raccolta Claude Code è la selezione per sviluppatori.
Domande frequenti
Dov'è la cartella delle Skills di Claude Code?
Le Skills a livello di progetto si trovano in .claude/skills/<name>/SKILL.md all'interno del tuo repository. Le Skills a livello utente si trovano in ~/.claude/skills/<name>/SKILL.md nella tua directory home e applicate a ogni progetto.
Le Skills per Claude Code funzionano in ChatGPT?
Il file .md sì, la scoperta automatica no. Puoi incollare o caricare lo stesso SKILL.md come istruzioni per un GPT personalizzato e si comporterà allo stesso modo. Ciò che ChatGPT non ha è la convenzione delle cartelle e il caricamento basato sulla descrizione, quindi lo attivi usando quel GPT anziché lasciare che Claude Code stabilisca che è pertinente.
Qual è la differenza tra una Skill per Claude Code e CLAUDE.md?
CLAUDE.md viene caricato a ogni turno e dovrebbe contenere informazioni brevi e permanenti sul progetto. Una Skill viene caricata solo quando la sua descrizione corrisponde all'attività e può essere lunga quanto necessario per la procedura. Le checklist lunghe appartengono alle Skills, non a CLAUDE.md.
Posso installare più di una Skill alla volta?
Sì. Ogni Skill ha la propria cartella in .claude/skills e Claude Code le indicizza tutte. Poiché, finché una Skill non serve, nel contesto vengono mantenute solo le descrizioni, averne 15 installate costa pochissimo.
Mi serve un server MCP per usare le Skills?
No. Le Skills sono istruzioni e funzionano con gli strumenti integrati di Claude Code (modifica dei file, shell, git). I server MCP aggiungono strumenti esterni come un database o un browser; una Skill può indicare a Claude come usare bene questi strumenti, ma non li richiede.
In sintesi
Una Skill per Claude Code è una cartella contenente un file SKILL.md, inserita in .claude/skills per il progetto oppure in ~/.claude/skills per te, che viene individuata in base alla descrizione e caricata solo quando serve. Mantieni CLAUDE.md breve, usa i comandi slash per le azioni deliberate, usa MCP per gli strumenti e usa le Skills per le competenze. Installane una, testala con tre formulazioni e una negativa, quindi aggiungi le altre in base alle esigenze del tuo flusso di lavoro.
Esplora tutte le Skills per sviluppatori nella raccolta di Skills per Claude Code su KissMySkills.
