Le Skills sono disponibili per gli utenti con piani free, Pro, Max, Team ed Enterprise. Questa funzione richiede che l'esecuzione del codice sia abilitata. Le Skills sono disponibili anche in beta per gli utenti di Claude Code e per tutti gli utenti API che utilizzano lo strumento di esecuzione del codice.
Le Custom Skills ti permettono di migliorare Claude con conoscenze specializzate e flussi di lavoro specifici della tua organizzazione o del tuo stile di lavoro personale. Questo articolo spiega come creare, strutturare e testare le tue Skills.
Le Skills possono essere semplici come poche righe di istruzioni o complesse come pacchetti multi-file con codice eseguibile. Le migliori Skills:
Risolvono un compito specifico e ripetibile
Hanno istruzioni chiare che Claude può seguire
Includono esempi quando utili
Definiscono quando devono essere utilizzate
Si concentrano su un flusso di lavoro piuttosto che cercare di fare tutto
Crea un file Skill.md
Ogni Skill consiste in una directory che contiene almeno un file Skill.md, che è il nucleo della Skill. Questo file deve iniziare con un frontmatter YAML per contenere i campi name e description, che sono metadati obbligatori. Può anche contenere metadati aggiuntivi, istruzioni per Claude o file di riferimento, script eseguibili o strumenti.
Campi di metadati obbligatori
name: Un nome user-friendly per la tua Skill (massimo 64 caratteri)
Esempio: Brand Guidelines
description: Una descrizione chiara di cosa fa la Skill e quando utilizzarla.
Questo è critico—Claude utilizza questo per determinare quando invocare la tua Skill (massimo 200 caratteri).
Esempio: Applica le linee guida del brand Acme Corp a presentazioni e documenti, inclusi colori ufficiali, font e utilizzo del logo.
Campi di metadati opzionali
dependencies: Pacchetti software richiesti dalla tua Skill.
Esempio: python>=3.8, pandas>=1.5.0
I metadati nel file Skill.md servono come primo livello di un sistema di progressive disclosure, fornendo solo le informazioni necessarie affinché Claude sappia quando la Skill dovrebbe essere utilizzata senza dover caricare tutto il contenuto.
Corpo Markdown
Il corpo Markdown è il secondo livello di dettaglio dopo i metadati, quindi Claude accederà a questo se necessario dopo aver letto i metadati. A seconda del tuo compito, Claude può accedere al file Skill.md e utilizzare la Skill.
Esempio Skill.md
Skill linee guida del brand
## Metadati
name: Brand Guidelines
description: Applica le linee guida del brand Acme Corp a tutte le presentazioni e i documenti
## Panoramica
Questa Skill fornisce le linee guida ufficiali del brand Acme Corp per creare materiali coerenti e professionali. Quando crei presentazioni, documenti o materiali di marketing, applica questi standard per assicurare che tutti gli output corrispondano all'identità visiva di Acme. Claude dovrebbe fare riferimento a queste linee guida ogni volta che crea materiali rivolti all'esterno o documenti che rappresentano Acme Corp.
## Colori del Brand
I nostri colori ufficiali del brand sono:
- Primario: #FF6B35 (Coral)
- Secondario: #004E89 (Navy Blue)
- Accento: #F7B801 (Gold)
- Neutro: #2E2E2E (Charcoal)
## Tipografia
Intestazioni: Montserrat Bold
Testo del corpo: Open Sans Regular
Linee guida per le dimensioni:
- H1: 32pt
- H2: 24pt
- Corpo: 11pt
## Utilizzo del Logo
Utilizza sempre il logo a colori interi su sfondi chiari. Utilizza il logo bianco su sfondi scuri. Mantieni uno spazio minimo di 0,5 pollici intorno al logo.
## Quando Applicare
Applica queste linee guida ogni volta che crei:
- Presentazioni PowerPoint
- Documenti Word per la condivisione esterna
- Materiali di marketing
- Rapporti per i clienti
## Risorse
Vedi la cartella delle risorse per i file del logo e i download dei font.
Aggiungi risorse
Se hai troppi contenuti da aggiungere a un singolo file Skill.md (ad esempio, sezioni che si applicano solo a scenari specifici), puoi aggiungere più contenuti aggiungendo file all'interno della tua directory Skill. Ad esempio, aggiungi un file REFERENCE.md contenente informazioni supplementari e di riferimento alla tua directory Skill. Farvi riferimento in Skill.md aiuterà Claude a decidere se ha bisogno di accedere a quella risorsa quando esegue la Skill.
Aggiungi script
Per Skills più avanzate, allega file di codice eseguibile a Skill.md, permettendo a Claude di eseguire il codice. Ad esempio, le nostre document skills utilizzano i seguenti linguaggi di programmazione e pacchetti:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Pacchetti per aiutare con la modifica dei file
strumenti di visualizzazione
Nota: Claude e Claude Code possono installare pacchetti da repository standard (Python PyPI, JavaScript npm) quando caricano Skills. Non è possibile installare pacchetti aggiuntivi al runtime con API Skills—tutte le dipendenze devono essere pre-installate nel container.
Pacchetto della tua skill
Una volta completata la cartella della tua Skill:
Assicurati che il nome della cartella corrisponda al nome della tua Skill.
Crea un file ZIP della cartella.
Lo ZIP dovrebbe contenere la cartella Skill come radice (non come sottocartella).
Struttura corretta:
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
Struttura non corretta:
my-Skill.zip
└── (file direttamente nella radice dello ZIP)
Testa la tua skill
Prima del caricamento
1. Rivedi il tuo Skill.md per chiarezza
2. Verifica che la descrizione rifletta accuratamente quando Claude dovrebbe utilizzare la Skill
3. Verifica che tutti i file referenziati esistano nelle posizioni corrette
4. Testa con prompt di esempio per assicurare che Claude la invochi appropriatamente
Dopo il caricamento su Claude
1. Abilita la Skill in Personalizza > Skills.
2. Prova diversi prompt che dovrebbero attivarla
3. Rivedi il ragionamento di Claude per confermare che sta caricando la Skill
4. Itera sulla descrizione se Claude non la utilizza quando previsto
Nota per i piani Team ed Enterprise: Per rendere una skill disponibile a tutti gli utenti della tua organizzazione, vedi Provisioning e gestione delle Skills per la tua organizzazione.
Best practice
Mantienila focalizzata: Crea Skills separate per diversi flussi di lavoro. Più Skills focalizzate si compongono meglio di una Skill grande.
Scrivi descrizioni chiare: Claude utilizza le descrizioni per decidere quando invocare la tua Skill. Sii specifico su quando si applica.
Inizia semplice: Inizia con istruzioni di base in Markdown prima di aggiungere script complessi. Puoi sempre espandere la Skill in seguito.
Usa esempi: Includi input e output di esempio nel tuo file Skill.md per aiutare Claude a capire come dovrebbe apparire il successo.
Testa in modo incrementale: Testa dopo ogni cambiamento significativo piuttosto che costruire una Skill complessa tutto in una volta.
Le Skills possono costruirsi l'una sull'altra: Mentre le Skills non possono fare riferimento esplicitamente ad altre Skills, Claude può utilizzare più Skills insieme automaticamente. Questa componibilità è una delle parti più potenti della funzione Skills.
Rivedi la specifica aperta Agent Skills: Segui le linee guida su agentskills.io, in modo che le skills che crei possano funzionare su piattaforme che adottano lo standard.
Per una guida più approfondita alla creazione di skills, fai riferimento a Best practice per la creazione di skills nella nostra Claude Docs.
Considerazioni sulla sicurezza
Esercita cautela quando aggiungi script al tuo file Skill.md.
Non codificare informazioni sensibili (chiavi API, password).
Rivedi qualsiasi Skill che scarichi prima di abilitarla.
Utilizza connessioni MCP appropriate per l'accesso ai servizi esterni.
Skills di esempio da consultare
Visita il nostro repository su GitHub per Skills di esempio che puoi utilizzare come template: https://github.com/anthropics/skills/tree/main/skills.