Costruisci il tuo primo Skill
Pianificare, scrivere e organizzare un file SKILL.md
⏱ Stima ~7 min
01 · Leggi
Prima di scrivere una riga, devi individuare un flusso di lavoro ripetibile.
Pensa a quello che dici sempre a Claude Code: "Usa functional component." "Prima scrivi i test." "Usa conventional commit." "Non aggiungere commenti al codice ovvio."
Ognuno di questi è un candidato perfetto per uno Skill. I migliori Skills catturano i flussi che segui ogni volta — non le richieste una tantum.
Chiediti: "Qual è il comando che scrivo a Claude Code almeno una volta alla settimana?" Quello è il tuo primo Skill.
Punti chiave
- Un buon Skill cattura flussi ripetibili, non task una tantum
- Pensa alle istruzioni che scrivi in ogni sessione di Claude Code
- Inizia con un flusso concreto, non con tutto insieme
- Uno Skill deve avere una posizione chiara — regole precise, non suggerimenti vaghi
02 · Esempio di codice
Ogni SKILL.md inizia con un YAML frontmatter racchiuso tra ---. Ecco i tre campi principali.
YAML Frontmatter
---
name: Code Reviewer
description: Reviews code for bugs, style, and best practices
instructions: Use this skill when reviewing pull requests or code changes
---
name è il nome che appare nell'elenco /skill. description dice a Claude (e a te) cosa fa questo Skill. instructions suggerisce a Claude quando attivarlo. Tutti e tre sono opzionali, ma è fortemente consigliato compilarli tutti.
03 · Quiz
Hai appena visto i tre campi standard del YAML frontmatter. Quale delle seguenti non è uno di quelli?
- name
- description
- language
- instructions
04 · Passo dopo passo
Costruiamo uno Skill reale passo dopo passo. Creiamo uno Skill "Code Reviewer" che applica gli standard di revisione del tuo team.
1. Crea la cartella dello Skill
Crea la struttura di cartelle nel tuo progetto. Esegui: mkdir -p .claude/skills/code-reviewer. Il flag -p crea le cartelle parent se non esistono. Questo inserisce lo Skill nel tuo progetto, dove può essere committato su git.
2. Scrivi il YAML frontmatter
Apri .claude/skills/code-reviewer/SKILL.md e aggiungi il blocco di metadata. Inizia con una riga ---, aggiungi i campi name, description e instructions, poi chiudi con un'altra riga ---.
3. Aggiungi il corpo delle istruzioni
Sotto il --- finale, scrivi le tue regole di revisione in linguaggio naturale. Usa titoli markdown per organizzare le sezioni e punti elenco per le regole specifiche. Sii preciso — "Controlla le SQL injection negli input utente" è molto meglio di "Rivedi il codice".
4. Testa con /skill
In una conversazione di Claude Code, scrivi /skill e verifica che il tuo nuovo Skill appaia nell'elenco. Selezionalo per attivarlo. Ora chiedi a Claude di revisionare del codice — dovrebbe rispettare le tue regole. Se non lo fa, affina lo Skill e riprova.
05 · Esempio di codice
Ecco lo Skill "Code Reviewer" completo — un SKILL.md pronto per la produzione.
code-reviewer/SKILL.md
---
name: Code Reviewer
description: Reviews code changes for bugs, security, and style
instructions: Use when asked to review code, PRs, or diffs
---
## Review Checklist
When reviewing code, check for:
- **Security**: SQL injection, XSS, command injection, hardcoded secrets
- **Error handling**: Are errors caught? Are they logged? Do they fail gracefully?
- **Edge cases**: What happens with empty input? Null values? Very large data?
- **Naming**: Are variables and functions named clearly?
- **Tests**: Are there tests for the new code? Do existing tests still pass?
## Output Format
Structure your review as:
1. **Summary** — one sentence overview
2. **Issues** — bullet list, severity (high/medium/low)
3. **Suggestions** — optional improvements (not blockers)
Il corpo usa markdown standard — titoli, grassetto, punti elenco. Claude lo legge come istruzioni da seguire. La checklist di revisione dice a Claude cosa guardare, il formato di output garantisce che ogni revisione sia coerente e strutturata.
06 · Completa
Il YAML frontmatter del file SKILL.md è racchiuso tra due righe _____
07 · Trascina per ordinare
Il file SKILL.md ha una struttura precisa. Pensa a cosa legge prima Claude quando carica uno Skill e ordina queste parti dall'alto verso il basso.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
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.