SKILL.md

Un SKILL.md è un file markdown che funge da unità fondamentale per una skill di Claude Code. È composto da due parti distinte: frontmatter YAML racchiuso tra marcatori ---, e contenuto markdown che fornisce le istruzioni che Claude segue quando la skill viene eseguita.

Il file SKILL.md risiede all'interno di una specifica struttura di directory. Per le skill personali disponibili in tutti i tuoi progetti, si trova in ~/.claude/skills/<skill-name>/SKILL.md. Per le skill specifiche del progetto, il percorso è .claude/skills/<skill-name>/SKILL.md. Se la skill fa parte di un plugin, si troverà in <plugin>/skills/<skill-name>/SKILL.md.

Il nome della directory contenente il file SKILL.md determina il comando che utilizzi per invocare la skill tramite un comando slash (ad esempio, /skill-name). Il campo name all'interno del frontmatter YAML, tuttavia, imposta l'etichetta di visualizzazione che appare negli elenchi delle skill. Un'eccezione si verifica con i file SKILL.md root di plugin, dove il campo name determina direttamente il nome del comando, poiché non esiste una directory di skill dedicata da cui derivarlo.

Oltre al file SKILL.md stesso, la directory della skill può contenere file aggiuntivi come documentazione di riferimento o script. Questi file supplementari vengono caricati da Claude Code solo quando sono necessari durante l'operazione della skill. Claude Code monitora attivamente queste directory di skill. Di conseguenza, le modifiche apportate a un file SKILL.md o l'aggiunta di nuovi file avranno effetto all'interno della sessione corrente senza richiedere un riavvio. Tuttavia, la creazione di una directory di skill di primo livello che non esisteva all'inizio della sessione richiederà un riavvio affinché Claude Code la riconosca.

Le skill di Claude Code aderiscono allo standard aperto Agent Skills, promuovendo l'interoperabilità e un approccio coerente allo sviluppo delle skill. Per una guida sulla creazione di file di skill ben strutturati, fai riferimento a Authoring Skills.