Un file SKILL.md è il cuore di ogni Claude Skill: un file Markdown che inizia con una breve intestazione YAML (un name e una description) e prosegue con le istruzioni che Claude deve seguire. La descrizione indica a Claude quando usare la Skill; il corpo gli indica come.
Se hai visto questo term e ti sei chiesto cosa ci sia davvero dentro, ecco l'anatomia di una SKILL.md, perché ogni parte è importante e come scriverne una efficace.
Cos'è SKILL.md
Una Claude Skill è una cartella e SKILL.md è il file obbligatorio nella sua radice. È semplice Markdown, quindi si apre in qualsiasi editor di testo. Claude la legge per apprendere una capacità - i passaggi, le regole e le migliori pratiche per un determinato tipo di attività. Gli elementi aggiuntivi facoltativi (modelli, script e file di riferimento) possono trovarsi nella stessa cartella, ma SKILL.md è l'unico file che ogni Skill deve avere.
Vuoi vedere una SKILL.md ben definita invece di crearne una da zero? Il frontmatter e le istruzioni di Yuri sono già scritti e testati per individuare bug, falle di sicurezza e problemi di prestazioni durante una revisione.
Visualizza Yuri - Skill AI per la revisione del codice →Le due parti di SKILL.md
1. Il frontmatter (metadati)
In cima c'è un piccolo blocco YAML racchiuso tra marcatori ---. Contiene i metadati essenziali - come minimo un name e una description:
---
name: weekly-report
description: formatta note grezze in base al nostro report settimanale standard. Usa questa Skill quando l'utente chiede un aggiornamento settimanale, un report sullo stato o di «mettere per iscritto la settimana».
---Questo blocco è speciale: quando inizia una sessione, Claude precarica solo il nome e la descrizione di ogni Skill installata, non l'intero file. In questo modo la finestra di contesto rimane leggera, ed è per questo che la descrizione svolge un ruolo così importante.
2. Il corpo (istruzioni)
Sotto il frontmatter, in Markdown normale, scrivi ciò che Claude dovrebbe effettivamente fare - idealmente come passaggi numerati chiari, con eventuali regole o esempi:
## Passaggi
1. Raggruppa gli appunti sotto i titoli Vittorie, In corso e Blocchi.
2. Limita ogni punto a una frase, al passato.
3. Concludi con un riepilogo di una riga intitolato "La prossima settimana".
4. Non inventare mai metriche che non compaiono negli appunti.Perché la descrizione è la riga più importante
L'attivazione dipende interamente dalla descrizione. Mentre lavori, Claude confronta la tua richiesta con la descrizione di ogni skill e carica il file completo solo quando trova una corrispondenza. Una descrizione vaga ("aiuta con i report") si attiva raramente. Una descrizione specifica ("usala quando l'utente chiede un aggiornamento settimanale o un report sullo stato") si attiva in modo affidabile. Se devi ricordare una sola regola, che sia questa: scrivi la descrizione indicando quando usare la skill, non solo che cos'è.
Come Claude usa il file
- All'avvio: Claude legge il nome e la descrizione di ogni skill.
-
Durante l'attività: se la tua richiesta corrisponde a una descrizione, Claude carica il file
SKILL.mdcompleto di quella skill (e tutte le risorse allegate). - Poi: Claude segue le istruzioni del corpo per completare il lavoro.
Questo approccio del "caricarla solo quando serve" si chiama divulgazione progressiva ed è ciò che ti consente di mantenere molte skill installate senza appesantire il contesto del modello.
Scrivere un buon SKILL.md
- Cura la descrizione. Indica chiaramente quando la skill deve attivarsi.
- Mantieni ridotta la prima versione. Da cinque a dieci righe di passaggi chiari sono meglio di un documento prolisso.
- Sii concreto. Indica passaggi numerati, regole esplicite e un breve esempio.
- Provala su attività reali. Espandila solo dove Claude non è all'altezza.
Devi scriverne una tu?
No. Scriverne uno tu è ottimo per i flussi di lavoro unici per te, ma se vuoi solo il risultato, le skill pronte all'uso includono già il loro SKILL.md, creato e testato. Esplora la libreria KissMySkills con oltre 1.000 skill, raccolte di prompt e agenti, oppure la raccolta di skill di Claude Code. Vuoi prima vederne una in azione? Prova un generatore gratuito o ottieni una skill gratuita.
Non tutti i file SKILL.md sono destinati ai programmatori: il frontmatter e le istruzioni di Ryan sono scritti per documenti destinati al consiglio di amministrazione, comunicazioni aziendali e briefing dirigenziali, senza bisogno di modifiche.
Visualizza lo Skill AI Ryan - Capo di gabinetto →Domande frequenti
SKILL.md è semplicemente Markdown?
Sì: è un file Markdown standard con un blocco di frontmatter YAML in cima. Si apre con qualsiasi editor di testo, senza bisogno di software speciale.
Cosa è necessario in un file SKILL.md?
Come minimo, un blocco di frontmatter con un nome e una descrizione. Il corpo con le istruzioni è ciò che rende utile lo Skill, ma sono i metadati a renderlo individuabile e attivabile.
Dove va collocato il file SKILL.md?
Nella radice della cartella dello Skill. In Claude Code, gli Skill si trovano ~/.claude/skills/<name>/ per uso personale oppure .claude/skills/<name>/ all'interno di un progetto, in SKILL.md nella radice della cartella.
Posso usare il contenuto di un file SKILL.md in ChatGPT o Gemini?
Sì. Le istruzioni sono portabili: incolla il corpo nelle istruzioni personalizzate di ChatGPT o Gemini per ottenere lo stesso comportamento. L'attivazione automatica tramite frontmatter è una funzione di Claude.
In sintesi:
Se preferisci evitare di scrivere personalmente il frontmatter YAML, Yuri - Revisore del codice è un'ottima scelta per gli sviluppatori, mentre Ryan - Capo di gabinetto è dedicato alla scrittura per dirigenti e aziende. Funzionano tutti in Claude, ChatGPT e qualsiasi chat AI, senza bisogno di programmare, con una garanzia soddisfatti o rimborsati di 30 giorni.
Inizia con un esempio funzionante
Il modo più rapido per capire SKILL.md è leggerne uno ben fatto. Scarica uno Skill gratuito, apri il file e osserva la struttura con frontmatter e passaggi in azione, poi leggi come installarlo in tre minuti.