Corpo di SKILL.md e file di riferimento
Scrivere istruzioni dettagliate e collegare contesto esterno
⏱ Stima ~5 min
01 · Leggi
Il corpo markdown sotto il frontmatter è dove sta il vero potere. Qui scrivi istruzioni dettagliate, esempi, vincoli e regole che Claude deve seguire.
Pensalo come un manuale di istruzioni ultra-specifico per un determinato task.
Usa titoli markdown per organizzare le sezioni, punti elenco per le regole, e code fence per gli esempi. Più sei chiaro e specifico, più Claude si comporta in modo coerente.
Un corpo che dice "scrivi buon codice" non serve — Claude ci prova già. Un corpo che dice "usa camelCase per le variabili, PascalCase per i componenti React, kebab-case per le classi CSS" è qualcosa che si può applicare.
Punti chiave
- Il corpo è markdown libero — titoli, punti elenco, code fence, grassetto
- Sii preciso: "usa camelCase per le variabili" batte "usa nomi buoni"
- Includi esempi di come appare un buon output
- Organizza con titoli così Claude trova le regole pertinenti in fretta
02 · Esempio di codice
Ecco uno Skill "API Developer" con un corpo ben strutturato — titoli, regole ed esempi di codice.
api-developer/SKILL.md (sezione corpo)
## API Conventions
- All endpoints return JSON
- Use kebab-case for URL paths: `/user-profiles` not `/userProfiles`
- Use camelCase for JSON fields: `{ "firstName": "Ada" }`
- Always include `Content-Type: application/json` header
## Error Response Format
Always return errors in this exact shape:
```json
{
"error": {
"code": "NOT_FOUND",
"message": "User with id 42 not found"
}
}
```
## Status Code Rules
- 200 for successful reads
- 201 for successful creates
- 400 for invalid input
- 404 for missing resources
- 500 should never be intentional — fix the bug
Claude legge ogni titolo, punto elenco ed esempio di codice. Quando poi scrivi "crea un endpoint GET /users", Claude applica automaticamente queste convenzioni — URL in kebab-case, JSON in camelCase, il formato di errore esatto che hai specificato.
03 · Leggi
A volte le tue istruzioni fanno riferimento a conoscenze esterne — schema del database, style guide, definizioni di tipi, template.
Invece di incollare tutto in SKILL.md (che diventerebbe enorme e difficile da mantenere), puoi collegare file di riferimento.
Mettili nella stessa cartella dello Skill e riferiscili dal corpo. Quando lo Skill è attivato, Claude legge i file collegati come contesto aggiuntivo.
Il vantaggio dei file di riferimento: sono la fonte di verità reale. Se il tuo schema cambia, Claude vede automaticamente la versione aggiornata — senza dover aggiornare lo Skill a mano.
Punti chiave
- I file di riferimento stanno nella stessa cartella Skill di SKILL.md
- Forniscono contesto senza appesantire il file Skill
- File di riferimento comuni: file schema, style guide, template, definizioni di tipi
- I file di riferimento restano aggiornati perché sono la fonte di verità
04 · Esempio di codice
Ecco uno Skill che collega uno schema Prisma come file di riferimento — dando a Claude una conoscenza completa della struttura del tuo database.
Struttura della cartella
.claude/skills/db-developer/
├── SKILL.md
└── schema.prisma
db-developer/SKILL.md
---
name: Database Developer
description: Writes database queries and migrations following our schema
---
## Context
Our database schema is defined in `schema.prisma` (included in this skill folder).
Always reference it when writing queries or migrations.
## Rules
- Never use raw SQL — use Prisma Client
- Always include `createdAt` and `updatedAt` on new models
- Foreign keys must have `onDelete: Cascade` unless specified otherwise
- Index any column used in WHERE clauses
Quando questo Skill è attivato, Claude può leggere schema.prisma per capire la struttura del tuo database. Se in seguito modifichi lo schema, Claude vede automaticamente la versione aggiornata — senza dover aggiornare lo Skill.
05 · Quiz
Immagina che il tuo schema del database cambi spesso. Perché usare un file di riferimento invece di incollare lo schema direttamente in SKILL.md?
- I file di riferimento si caricano più velocemente del contenuto inline
- SKILL.md ha un limite rigido di 100 righe
- Claude riesce a leggere solo file separati da SKILL.md
- I file di riferimento restano aggiornati con la sorgente e tengono SKILL.md focalizzato
06 · Abbina
Hai imparato le quattro parti di uno Skill. Abbina ogni componente alla sua funzione — pensa a dove vivono metadata, istruzioni e contesto esterno.
(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.