Glossario di Claude Code
Personal vs project skills
Le skill possono risiedere localmente per uso personale, all'interno di un progetto o come parte di un plugin.
Chiamato anche: ~/.claude/skills, .claude/skills, where do skills live, skill locations
Le skill possono trovarsi in uno dei tre posti: personali, di progetto o di plugin.
Le skill personali risiedono in ~/.claude/skills/<skill-name>/SKILL.md e sono disponibili in tutti i tuoi progetti. Le skill specifiche del progetto sono memorizzate in .claude/skills/<skill-name>/SKILL.md all'interno della directory del progetto. Queste skill di progetto sono destinate ad essere incluse nel controllo di versione, rendendole accessibili al tuo team. Le skill dei plugin si trovano all'interno della struttura delle directory di un plugin in <plugin>/skills/<skill-name>/SKILL.md.
Quando le skill condividono lo stesso nome tra queste posizioni, la precedenza è determinata come segue: le skill enterprise sovrascrivono le skill personali, e le skill personali sovrascrivono le skill di progetto. Le skill a uno qualsiasi di questi livelli hanno anche la precedenza sulle skill incluse con lo stesso nome. Ad esempio, una skill personalizzata di code-review nella directory .claude/skills/ del tuo progetto sostituirà la versione predefinita inclusa.
Le skill dei plugin utilizzano uno spazio dei nomi plugin-name:skill-name, che impedisce conflitti di denominazione con le skill a altri livelli. Le skill di progetto vengono caricate dalle directory .claude/skills/ a partire dalla tua directory di lavoro corrente e risalendo attraverso le directory padre fino alla root del repository. Ciò garantisce che le skill definite a livello di repository siano accessibili anche quando si lavora in sottodirectory.
Le skill possono anche essere caricate su richiesta da directory .claude/skills/ annidate. Quando Claude interagisce con i file in una sottodirectory, tutte le skill all'interno di .claude/skills/ di quella sottodirectory diventano disponibili. Questo meccanismo è particolarmente utile nei monorepo, dove i singoli pacchetti possono fornire le proprie skill. Se una skill annidata ha lo stesso nome di un'altra skill, entrambe rimangono disponibili e la skill annidata viene referenziata utilizzando il suo percorso, ad esempio, /apps/web:deploy.
Una voce <skill-name> può anche essere un collegamento simbolico a una directory situata altrove nel tuo filesystem. Un'eccezione alle normali regole di accesso ai file si verifica con il flag --add-dir e il comando /add-dir: una directory .claude/skills/ all'interno di una directory aggiunta viene caricata automaticamente, a differenza delle directory aggiunte tramite l'impostazione permissions.additionalDirectories.