Pattern e best practice degli Skills
Pattern comuni, anti-pattern e abitudini dei migliori costruttori di Skills
⏱ Stima ~8 min
01 · Leggi
Ora che sai come funzionano gli Skills, vediamo i pattern che gli sviluppatori usano ogni giorno nella pratica.
Gli Skills più popolari rientrano in alcune categorie:- Stile del codice — applica convenzioni di naming, regole di formattazione, pattern strutturali - Code review — checklist coerente per revisionare PR e modifiche al codice - Messaggi di commit — applica formati come Conventional Commits - Test — allineati al framework di test e ai pattern del tuo progetto - Documentazione — standardizza come scrivere documentazione, commenti e README
Ogni pattern segue la stessa struttura: regole chiare, esempi specifici, formato di output preciso. Vediamo i due più utili.
Punti chiave
- Gli Skill di stile del codice applicano convenzioni di naming, formattazione e struttura
- Gli Skill di review forniscono una checklist coerente per la code review
- Gli Skill per i messaggi di commit applicano formati come Conventional Commits
- Gli Skill di test si allineano ai pattern di test già presenti nel tuo progetto
- Gli Skill di documentazione standardizzano come scrivere la documentazione
02 · Esempio di codice
Ecco uno Skill che applica il formato Conventional Commits a tutti i messaggi di commit.
commit-style/SKILL.md
---
name: Commit Message Style
description: Enforces Conventional Commits format
instructions: Use when creating git commits
---
## Format
All commits must follow Conventional Commits:
```
<type>(<scope>): <description>
[optional body]
```
## Types
- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation only
- `refactor`: Code change that neither fixes nor adds
- `test`: Adding or updating tests
- `chore`: Maintenance (dependencies, CI, build)
## Rules
- Description must be lowercase, no period at the end
- Scope is optional but encouraged
- Body should explain WHY, not WHAT (the diff shows what)
- Max 72 characters for the first line
## Examples
Good: `feat(auth): add password reset flow`
Good: `fix(api): handle null response from payment gateway`
Bad: `Fixed stuff`
Bad: `Update code`
Nota quanto è preciso — formato esatto, tipi elencati, limite di caratteri, esempi di buono e cattivo. Più le tue regole sono specifiche, più i commit di Claude sono coerenti. Istruzioni vaghe come "scrivi buoni messaggi di commit" non servono a nulla.
03 · Esempio di codice
Ecco uno Skill che fa allineare Claude alle convenzioni di test già presenti nel tuo progetto.
test-writer/SKILL.md
---
name: Test Writer
description: Writes tests matching project conventions
instructions: Use when writing or updating tests
---
## Conventions
- Use `describe` / `it` blocks (not `test`)
- Test file goes next to source: `Foo.ts` → `Foo.test.ts`
- Use `vi.fn()` for mocks (Vitest, not Jest)
- Arrange-Act-Assert pattern in every test
## What To Test
- Happy path first
- Error cases and edge cases
- Boundary values (0, 1, -1, empty string, null)
- Never test implementation details — test behavior
## Naming
`it('should return 404 when user not found')`
Not: `it('test user')`
Questo Skill fa riferimento al framework di test specifico del progetto (Vitest) e ai pattern usati (describe/it, vi.fn). Un'istruzione generica come "scrivi buoni test" non serve — Claude ci prova già. Questo Skill gli dice le tue convenzioni specifiche.
04 · Quiz
Ricorda: uno Skill dovrebbe aggiungere regole che Claude non potrebbe conoscere da solo. Quale delle seguenti istruzioni è abbastanza specifica da cambiare davvero il comportamento di Claude?
- Sii un assistente utile che scrive buon codice
- Quando scrivi endpoint API, restituisci JSON con chiavi camelCase, usa URL kebab-case e usa i codici di errore del file error-codes.ts
- Usa sempre le best practice quando scrivi codice
- Scrivi codice come farebbe un ingegnere senior
05 · Trascina per ordinare
Pensa a cosa fa più differenza sulla qualità di uno Skill. Uno Skill vago senza esempi è molto peggio di uno specifico — ordina queste pratiche dalla più importante alla meno importante.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
06 · Leggi
Alcuni Skills fanno lavorare Claude peggio. Ecco cosa evitare:
Troppo vago: "Scrivi codice buono e pulito." Claude ci prova già. Il tuo Skill deve aggiungere regole specifiche che Claude non potrebbe conoscere da solo.
Troppo lungo: Uno Skill da 500 righe con regole per ogni possibile scenario manda in tilt il contesto di Claude. Tieni gli Skills focalizzati su un flusso. Più Skills focalizzati battono uno Skill gigantesco.
Ripetere comportamenti già presenti: Claude sa già formattare il codice, scrivere markdown e usare git. Non sprecare spazio nello Skill su cose che Claude fa già bene di default.
Regole contraddittorie: "Aggiungi sempre commenti" + "tieni il codice al minimo" crea confusione. Prima di testare, controlla che le tue regole non siano in conflitto tra loro.
Punti chiave
- Non scrivere Skills vaghi — sii specifico o non scriverli
- Non scrivere Skills giganteschi — un flusso focalizzato per Skill
- Non ripetere cose che Claude fa già bene di default
- Controlla che le regole dello Skill non siano in contraddizione
07 · Leggi
Ora hai un superpotere che la maggior parte degli utenti di Claude Code non conosce: la capacità di insegnare a Claude esattamente come lavori tu.
Ogni team ha le sue convenzioni. Ogni sviluppatore ha le sue preferenze. Gli Skills trasformano quelle regole non dette in istruzioni permanenti, condivisibili e versionabili.
Inizia in piccolo. Scegli la cosa che ripeti più spesso a Claude, trasformala in uno Skill. Testa, affina, committa. Poi aggiungine un altro. Nel tempo, la tua collezione di Skills diventa un moltiplicatore di forza — ogni Skill che scrivi rende Claude più bravo per il tuo lavoro specifico.
La differenza tra un assistente AI generico e un flusso AI personalizzato? Gli Skills.
Punti chiave
- Inizia con uno Skill per l'istruzione che ripeti più spesso
- Itera: testa, affina, committa
- Condividi gli Skill di progetto via git, così tutto il team ne beneficia
- Accumula la collezione nel tempo — ogni Skill rende Claude più bravo per il tuo lavoro
- Gli Skills sono la differenza tra un assistente AI generico e un flusso AI personalizzato
08 · Quiz
Hai scritto uno Skill che dice "scrivi codice buono e pulito". Dopo il test, l'output di Claude non sembra diverso. Perché?
- Il file SKILL.md ha un errore di sintassi
- Gli Skills funzionano solo con il modello Opus
- L'istruzione è troppo vaga — Claude ci prova già a scrivere buon codice
- Devi riavviare Claude Code dopo aver aggiunto uno Skill
09 · Completa
Uno Skill da 500 righe che copre ogni possibile scenario è un anti-pattern. Dovresti scrivere più Skill _____, ognuno focalizzato su un flusso.
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.