# Prompt per creare e provare una skill

Le cinque regole di Anthropic per le skill · https://www.riccardobelli.com/regole-skill-anthropic/

Le parti da cambiare sono tra parentesi quadre.

## 1. Trasforma il lavoro in una skill

Nella chat dove hai appena fatto il lavoro con Claude (Claude A).

```
Abbiamo appena finito [il lavoro, per esempio il preventivo per Rossi Srl].
Trasformalo in una skill che rifaccia questo lavoro ogni volta che serve.

Prima rileggi tutta la conversazione e fammi la lista di quello che ti ho spiegato:
regole, preferenze, correzioni che ti ho fatto, file che hai dovuto aprire.
Segna le cose che ti ho ripetuto più di una volta.

Poi scrivi la skill in .claude/skills/[nome-skill]/SKILL.md con queste regole:
- name: solo minuscole, numeri e trattini
- description: in terza persona, cosa fa e quando va usata, con le parole che userei io per chiederla
- nel corpo solo quello che non sai già, senza spiegarmi cose ovvie
- un esempio vero preso da questo lavoro: la mia richiesta e il risultato finale
- sotto le 500 righe: tabelle, listini e testi lunghi in file a parte nella stessa cartella
- ogni file a parte richiamato direttamente dal SKILL.md, con una riga che dice quando aprirlo

Mostrami la skill prima di salvarla.
```

Su Claude.ai togli la riga con il percorso .claude/skills/ e chiedi la cartella della skill in un file ZIP: la carichi da Personalizza, nella sezione Skill.

## 2. Prova la skill in una chat nuova (Claude B)

```
Usa la skill [nome-skill] per fare questo lavoro:
[incolla una richiesta vera, diversa da quella con cui hai costruito la skill]

Lavora come faresti normalmente.
Quando hai finito, dimmi:
1. quali file della skill hai aperto e in che momento
2. dove le istruzioni non erano chiare o mancava qualcosa
3. cosa hai dovuto decidere da solo perché la skill non lo diceva
```

## 3. Torna da Claude A con quello che hai visto

```
Ho provato la skill in un'altra chat su questo lavoro: [la richiesta].
Ecco cosa è andato storto: [quello che hai visto, per esempio ha usato un prezzo che non è nel listino].
Ecco cosa ha risposto la chat di prova: [incolla le sue tre risposte].

Correggi il SKILL.md perché non succeda più.
Cambia solo quello che serve e mostrami le modifiche prima di salvarle.
```

## Due descrizioni a confronto

```
Vaga:
description: Aiuta con i documenti

Scritta bene:
description: Estrae testo e tabelle dai PDF, compila moduli e unisce documenti. Da usare quando si lavora con file PDF o quando l'utente nomina PDF, moduli o estrazione di dati da un documento.
```

Fonte delle regole: Skill authoring best practices, la guida ufficiale di Anthropic.
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices