Per creare una skill di Claude, scrivi una cartella con un solo file al suo interno: un SKILL.md che inizia con un nome e una descrizione, seguiti da istruzioni in linguaggio naturale. Comprimi la cartella in un file ZIP, caricala in Claude (oppure inseriscila in ~/.claude/skills/ per Claude Code) e Claude la caricherà ogni volta che una richiesta corrisponde alla descrizione. Niente codice, niente SDK, nessuna fase di compilazione.
Su questa pagina
- Cosa ti serve prima di iniziare
- Passaggio 1: scegli un lavoro e definisci quando è "completato"
- Passaggio 2: crea la cartella e il file SKILL.md
- Passaggio 3: scrivi il frontmatter (la parte che decide quando si attiva)
- Passaggio 4: scrivi le istruzioni come un metodo, non come uno stato d'animo
- Passaggio 5: aggiungi un esempio di output completo
- Passaggio 6: impacchettalo e installalo
- Passaggio 7: testalo come si deve
- Modello gratuito di Skill di Claude (copia e adatta)
- Cinque errori che rendono inutile uno Skill
- Lascia che Claude scriva la prima bozza per te
- Crearla tu o partire da una Skill già pronta?
Questo è l'intero meccanismo. Ciò che distingue una skill che si attiva ogni volta e produce risultati pronti per essere utilizzati da una che non si attiva mai dipende da circa sei decisioni, e questa guida le illustra in ordine. Alla fine troverai un modello gratuito da copiare e una checklist per testare la skill prima di affidarti a essa.
Se non hai familiarità con l'idea in sé, inizia da Cosa sono le Claude Skills? e poi torna qui. Questa pagina presuppone che tu sappia cos'è una skill e voglia crearne una.
Cosa ti serve prima di iniziare
- Un account Claude con l'esecuzione del codice attivata. Le skill funzionano con i piani Free, Pro, Max, Team ed Enterprise, ma l'impostazione per l'esecuzione del codice e la creazione di file deve essere abilitata. Nei piani Team ed Enterprise, potrebbe essere necessario che un amministratore attivi prima le skill per l'organizzazione.
- Un editor di testo. Qualsiasi strumento che permetta di salvare testo semplice: VS Code, TextEdit in modalità testo semplice, Notepad.
- Un'attività ripetibile. Non "marketing". Qualcosa come "trasformare la trascrizione di una chiamata commerciale in una nota CRM nel nostro formato" o "esaminare un contratto alla ricerca dei nostri cinque segnali d'allarme standard". Più il lavoro è circoscritto, migliore sarà la skill.
- Due o tre esempi reali di un buon risultato. Report, email e brief precedenti che saresti felice di inviare. Sono il miglior materiale di partenza per una skill.
Passaggio 1: scegli un lavoro e definisci quando è "completato"
La maggior parte delle skill che falliscono fallisce qui, prima ancora che venga scritta una riga. Una skill che cerca di coprire "tutto ciò che fa un responsabile marketing" finisce per avere una descrizione vaga, attivarsi nei momenti sbagliati e fornire risposte generiche anche quando si attiva.
Scrivi due frasi prima di qualsiasi altra cosa:
- Il trigger: "Usala quando qualcuno chiede X o fornisce Y."
- Il risultato: "L'output è una Z con queste sezioni, di questa lunghezza e con questo tono."
Esempio: "Usala quando qualcuno incolla la trascrizione di una chiamata con un cliente e chiede degli appunti. L'output è una nota CRM con Riepilogo, Punti critici, Budget, Prossimo passo e Rischio, di meno di 200 parole, scritta per un responsabile vendite che non era presente alla chiamata." Se non riesci a scrivere queste due frasi, dividi il lavoro in due skill.
Passaggio 2: crea la cartella e il file SKILL.md
Una skill è una cartella il cui nome corrisponde a quello della skill. Al suo interno, l'unico file obbligatorio è SKILL.md (il nome del file distingue tra maiuscole e minuscole). Gli extra facoltativi vanno nella stessa cartella:
| Percorso | Obbligatorio? | A cosa serve |
|---|---|---|
call-notes/SKILL.md |
Sì | Frontmatter più le istruzioni che Claude segue |
call-notes/resources/example-output.md |
Consigliato | Un esempio completo del risultato da produrre |
call-notes/resources/style-guide.md |
Facoltativo | Materiale di riferimento più lungo che Claude legge solo quando serve |
call-notes/scripts/ |
Facoltativo | Script Python o shell per i passaggi che devono essere esatti, come l'analisi di un CSV |
Mantieni il nome della cartella in minuscolo con i trattini, ad esempio call-notes o quarterly-report. La stessa stringa va nel campo nome campo nel passaggio successivo.
Passaggio 3: scrivi il frontmatter (la parte che decide quando si attiva)
Il file inizia con un breve blocco YAML tra due righe composte da tre trattini. Sono obbligatori due campi:
-
name- lettere minuscole, numeri e trattini, fino a 64 caratteri. Diventa l'identificatore e, in Claude Code, il comando slash (/call-notes). -
description- fino a 1.024 caratteri. È l'unica parte che Claude legge per ogni skill installata all'inizio di una sessione. Decide se la skill viene caricata.
Scrivi la descrizione come se stessi dando istruzioni a un collega che deve decidere in un secondo se una richiesta è di sua competenza. Inizia indicando cosa produce la skill, poi elenca le situazioni e le frasi che dovrebbero attivarla. Confronta:
- Debole: "Aiuta con le note di vendita."
- Efficace: "Trasforma la trascrizione di una chiamata di vendita o di analisi delle esigenze in una nota CRM strutturata (Riepilogo, Problemi, Budget, Prossimo passo, Rischio) di massimo 200 parole. Usala quando l'utente incolla la trascrizione di una chiamata, il testo della registrazione di una riunione o appunti informali e chiede note, un riepilogo, una voce CRM o un riepilogo per il follow-up."
La versione efficace specifica l'input, l'output e le parole che le persone digitano davvero. È questo che fa sì che la skill si attivi in modo affidabile e rimanga inattiva negli altri casi.
Passaggio 4: scrivi le istruzioni come un metodo, non come uno stato d'animo
Tutto ciò che segue il frontmatter è Markdown che Claude segue una volta caricata la skill. L'errore comune è una lunga descrizione del personaggio ("Sei un esperto di vendite di livello mondiale con 20 anni di esperienza...") senza alcuna procedura. Claude non ha bisogno di una storia personale. Ha bisogno di passaggi, regole e un formato di output definito. Una struttura che funziona per la maggior parte delle skill aziendali:
- Input - ciò che fornirà l'utente e cosa chiedere se manca (massimo due domande, poi procedi con le ipotesi dichiarate).
- Flusso di lavoro - passaggi numerati nell'ordine in cui li eseguirebbe un professionista scrupoloso.
- Formato dell'output - le sezioni, i titoli, la lunghezza e il tono esatti.
- Regole - le cose che devono sempre accadere o non accadere mai ("non inventare mai una cifra di budget; scrivi 'non discusso'").
- Controllo qualità - un breve elenco di controlli che Claude esegue prima di rispondere.
Punta a qualcosa che stia in una o due schermate. Se il file supera all'incirca le 500 righe, sposta il materiale di riferimento (guide di stile lunghe, listini prezzi, testi delle policy) in file nella cartella resources/ e indica a Claude in SKILL.md quando aprirli. Claude carica questi file aggiuntivi solo quando l'attività lo richiede, mantenendo leggero il contesto. Per ulteriori informazioni sulla struttura del file, consulta Che cos'è un file SKILL.md?
Passaggio 5: aggiungi un esempio di output completo
Un esempio insegna il formato più rapidamente di qualsiasi quantità di descrizioni. Inserisci un deliverable realistico e completo in resources/example-output.md e fai riferimento a esso nel flusso di lavoro ("abbina la struttura e la lunghezza di resources/example-output.md"). Usa un vero lavoro passato, modificando nomi e cifre, non un segnaposto pieno di parentesi. Anche il nostro catalogo segue la stessa regola: ogni Skill viene distribuito con un output di esempio, perché è il segno più chiaro che qualcuno abbia effettivamente testato ciò che ha realizzato.
Passaggio 6: impacchettalo e installalo
In Claude (web e desktop): comprimi la cartella in modo che la cartella stessa si trovi nella radice dell'archivio zip (call-notes.zip contenente call-notes/SKILL.md). Apri la sezione degli Skill nelle impostazioni, carica il file zip e attiva lo Skill. Avvia una nuova chat e formula una richiesta che corrisponda alla descrizione.
In Claude Code: non serve alcun file zip. Inserisci la cartella in ~/.claude/skills/ per usarla in ogni progetto, oppure in .claude/skills/ all'interno di un repository per condividerla con tutti coloro che lavorano su quel repository. Digita /call-notes oppure descrivi semplicemente l'attività. Claude Code rileva le modifiche alla cartella senza bisogno di un riavvio.
La guida completa per ogni superficie, incluso dove si trovano i file e cosa fare quando un caricamento viene rifiutato, è disponibile in Come installare uno Skill di Claude. Gli sviluppatori che lavorano soprattutto nel terminale dovrebbero leggere anche Skills di Claude Code.
Passaggio 7: testalo come si deve
Uno Skill provato una sola volta non è stato testato. Esegui questo controllo prima di condividerlo con un team:
- Test di attivazione (5 prompts). Scrivi cinque richieste che dovrebbero attivare lo Skill, formulate in modo diverso. Conta quante lo attivano. Meno di quattro significa che la descrizione deve includere più parole usate realmente dall'utente.
- Test del silenzio (5 prompts). Scrivi cinque richieste simili che non dovrebbero attivarlo. Se si attiva per una di esse, restringi la descrizione.
- Test degli input mancanti. Fornisci metà degli input. Dovrebbe fare una domanda breve o dichiarare le proprie supposizioni, non inventare fatti.
- Test del formato. Confronta tre output affiancati con il tuo esempio. Stesse sezioni, stessa fascia di lunghezza, stesso tono?
- Test dei casi limite. Inserisci l'input reale più disordinato che hai: una trascrizione prolissa, un foglio di calcolo mezzo vuoto.
Correggi la descrizione per i problemi di attivazione e il flusso di lavoro o le regole per i problemi di output. Mantieni un breve registro delle modifiche in fondo al file, così saprai quale versione usa il tuo team.
Modello gratuito di Skill di Claude (copia e adatta)
Sostituisci le parti in maiuscolo, elimina ciò che non ti serve e salvalo come SKILL.md all'interno di una cartella con lo stesso nome del nome campo.
---
name: nome-del-tuo-skill
description: Produce UN DELIVERABLE SPECIFICO (sezioni, lunghezza) a partire da UN INPUT SPECIFICO. Usalo quando l'utente CHIEDE X, INCOLLA Y o menziona Z. Non usarlo per UN'ATTIVITÀ SIMILE CHE SPETTA ALTROVE.
---
# TITOLO DEL TUO SKILL
## Scopo
Una o due frasi: a chi è rivolto e come si presenta un risultato "completo".
## Input
- Obbligatorio: COSA DEVE FORNIRE L'UTENTE
- Facoltativo: COSA MIGLIORA IL RISULTATO
- Se manca un input obbligatorio, poni al massimo due domande brevi,
poi procedi ed elenca le tue ipotesi all'inizio dell'output.
## Flusso di lavoro
1. Leggi l'input e individua gli ELEMENTI CHIAVE.
2. Verificalo rispetto a REGOLE O CRITERI.
3. Prepara l'output nel formato seguente.
4. Esegui il controllo qualità, correggi tutto ciò che non lo supera, poi rispondi.
## Formato di output
- Sezione 1: NOME - COSA INSERIRE QUI (lunghezza)
- Sezione 2: NOME - COSA INSERIRE QUI (lunghezza)
- Sezione 3: NOME - COSA INSERIRE QUI (lunghezza)
Segui la struttura e la lunghezza di resources/example-output.md.
## Regole
- Non inventare mai cifre, nomi o date. Scrivi invece "non fornito".
- Usa un inglese semplice. Niente introduzioni riempitive.
- REGOLA SPECIFICA DEL TUO TEAM O DEL TUO SETTORE.
## Controllo qualità
- Tutte le sezioni sono presenti e nell'ordine corretto?
- Ogni affermazione è riconducibile all'input?
- Rispetta il limite di lunghezza?
## Registro delle modifiche
- v1.0 PRIMA VERSIONE, DATA
Vuoi vedere come sono fatti gli Skill completi? Esempi di Skill di Claude analizza dodici file SKILL.md reali riga per riga: è il modo più rapido per capire quanto dettaglio è sufficiente.
Cinque errori che rendono inutile uno Skill
- Una descrizione che dice cos'è lo Skill, non quando usarlo. "Un copywriter esperto" non si attiva mai. "Scrive testi per pagine prodotto a partire da un elenco di funzionalità quando l'utente chiede una descrizione del prodotto, testi per una PDP o testi per una scheda prodotto" invece sì.
- Un solo Skill per un intero reparto. Budget, buste paga e audit in un unico file ti danno tre mezze risposte. Crea tre Skill.
- Nessun formato di output. Senza di esso, ogni esecuzione è diversa e nessuno si fida.
- Segreti nel file. Non inserire mai chiavi API, password o dati dei clienti in una Skill. Chiunque la riceva può leggerla.
- Installare la Skill di qualcun altro senza averla letta. Una Skill è un insieme di istruzioni che Claude seguirà, talvolta con script. Leggila come leggeresti uno script prima di eseguirlo.
Lascia che Claude scriva la prima bozza per te
Non devi partire da un file vuoto. Claude può intervistarti sull'attività, preparare una bozza del frontmatter e del flusso di lavoro, generare un esempio di output e proporre i prompt di test qui sopra. Anthropic include una Skill integrata chiamata skill-creator proprio per questo e puoi anche chiedere con parole semplici: "Fammi un'intervista su come scrivo il nostro report settimanale per i clienti, poi scrivi uno SKILL.md per farlo." La bozza avrà bisogno delle tue modifiche, soprattutto per la descrizione e le regole, ma elimina gran parte della digitazione.
Preferisci un modulo alla chat? Il Claude Skill Builder gratuito trasforma una breve descrizione dell'attività in un SKILL.md pronto, con frontmatter e un flusso di lavoro, che puoi copiare o scaricare come .zip per Claude.ai e Claude Code. Non è necessaria la registrazione.
Vuoi che il colloquio, l'autotest e la preparazione del pacchetto siano fatti per te? Claude Skill Creator ($19) è una Skill che crea Skills: ti fa domande sull'attività, sulle richieste che le persone digitano davvero e su ciò che non deve mai accadere, scrive una cartella completa della Skill con SKILL.md e un esempio di output, verifica la descrizione con richieste che dovrebbero e non dovrebbero attivarla e prepara la cartella per Claude, Claude Code e l'API. Per verificare una Skill che hai scritto o scaricato, usa Claude Skill Reviewer & Security Linter oppure ottieni entrambi, oltre alle Skills per la revisione di prompt, MCP e codice, nel Build Your Own Claude Skills Kit ($49).
Crearla tu o partire da una Skill già pronta?
Creala tu quando il flusso di lavoro è unico per il tuo team, quando contiene conoscenze interne che nessuno al di fuori possiede o quando ti piace perfezionarla iterativamente. Parti da una Skill già pronta quando l'attività corrisponde a un ruolo standard (contabilità, brief SEO, revisione di contratti, risposte all'assistenza) e preferisci trascorrere il pomeriggio sul lavoro anziché sulle istruzioni. Una Skill già pronta della nostra libreria di Skills per Claude costa $19, include un esempio di output ed è un semplice file Markdown che puoi aprire e modificare, quindi funziona anche come modello di partenza per la tua versione.
In ogni caso, il prossimo passo è lo stesso: scegli un'attività che ripeti ogni settimana, scrivi le due frasi del Passaggio 1 e avrai una Skill funzionante entro la fine della giornata.