Testare e distribuire gli Skills
Iterare sugli Skills e condividerli col team
⏱ Stima ~6 min
01 · Leggi
Scrivere uno Skill è solo metà del lavoro. Devi testarlo — e iterare.
Uno Skill che sulla carta sembra perfetto può produrre output incoerenti in pratica. Magari Claude rispetta 4 regole su 5 e ne salta una. Magari interpreta un'istruzione ambigua in modo diverso da come intendevi.
Il ciclo di test è semplice: attiva lo Skill, dai a Claude un task che dovrebbe attivarlo, controlla se l'output rispetta le tue regole, se non va affina lo Skill.
Come il codice, gli Skills migliorano con l'iterazione. La maggior parte degli Skills richiede 2-3 cicli di rifinitura prima di funzionare in modo stabile.
Punti chiave
- Attiva con /skill, dai a Claude un task pertinente per testare lo Skill
- Controlla l'output rispetto a ogni regola nel corpo dello Skill
- Testa i casi limite — cosa succede con input insoliti?
- Itera: la maggior parte degli Skills richiede 2-3 cicli di rifinitura
- Usa git per il version control degli Skills — sono file come gli altri
02 · Passo dopo passo
Segui questo flusso ogni volta che crei o aggiorni uno Skill.
1. Crea o aggiorna lo Skill
Scrivi o modifica il tuo file SKILL.md. Salvalo in .claude/skills/your-skill/SKILL.md. Se stai aggiornando, cambia una cosa alla volta così puoi vedere l'effetto.
2. Attiva con /skill
In una conversazione di Claude Code, scrivi /skill e scegli il tuo Skill dall'elenco. Claude carica le tue istruzioni e le segue per il resto della conversazione.
3. Dai a Claude un task pertinente
Chiedi a Claude di fare qualcosa che dovrebbe attivare le regole del tuo Skill. Per uno Skill di code review, chiedigli di revisionare del codice. Per uno Skill sui messaggi di commit, chiedigli di fare un commit. Usa input reali, non esempi di giocattolo.
4. Controlla l'output
L'output rispetta ogni regola del tuo Skill? Vai attraverso ogni punto elenco, ogni requisito di formato, ogni vincolo. Controlla tutto — una conformità parziale significa che lo Skill va rifinito.
5. Affina e ripeti
Se qualcosa non va, aggiorna il corpo dello Skill. Sii più specifico dove Claude si discosta. Aggiungi esempi di output corretto. Rimuovi le formulazioni ambigue. Poi testa di nuovo con lo stesso task.
6. Committa con git
Quando lo Skill funziona in modo stabile su più casi di test, committalo. Gli Skills sono file — appartengono al version control come tutto il resto. git add .claude/skills/ && git commit -m 'feat: add code-reviewer skill'
03 · Leggi
Quando lo Skill funziona bene, decidi dove metterlo. Nella prima lezione hai imparato che ci sono due posizioni: gli Skill di progetto (.claude/skills/) si committano su git e si condividono col team, gli Skill utente (~/.claude/skills/) sono personali e validi per tutti i tuoi progetti.
La regola è semplice: se è una convenzione del team, committala come Skill di progetto. Se è una preferenza personale, tienila come Skill utente.
Punti chiave
- Skill di progetto: committato su git → tutto il team ne beneficia
- Skill utente: rimane in locale → solo preferenze personali
- Gli Skill di progetto si committano come qualsiasi altra modifica al codice
04 · Quiz
Hai appena creato uno Skill che applica il formato dei messaggi di commit del team: ogni commit deve iniziare con un prefisso di tipo come 'feat:' o 'fix:'. Deve essere uno Skill di progetto o uno Skill utente?
- Skill di progetto — è una convenzione del team, si committa su git
- Skill utente — rimane in ~/.claude/skills/ per uso personale
- Entrambi vanno bene
- Dovrebbe stare in un file di configurazione, non in uno Skill
05 · Completa
Gli Skills salvati in ~/.claude/skills/ si chiamano Skill _____, perché ti seguono su tutti i progetti.
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.