---
name: crea-skill
description: >
  Usa questa skill quando l'utente chiede di "creare una skill", "scrivere una
  nuova skill", "fare lo scaffold di una skill", "trasformare questa procedura in
  una skill", o quando descrive un'attività ripetitiva che fa "sempre allo stesso
  modo" e vuole codificarla. Genera un SKILL.md ben formato (frontmatter + corpo)
  e spiega perché il `description` è il pezzo che conta.
---

# Crea una skill

Una **skill** è una cartella con dentro un file `SKILL.md`: un *frontmatter*
(`name`, `description`) seguito dalle *istruzioni* in Markdown. È il modo per
dire al modello "ecco come faccio SEMPRE questa cosa" → smetti di ripetere la
procedura a voce, la versioni una volta.

## La regola d'oro: il `description` è un ROUTER, non documentazione

Il modello legge **solo il frontmatter** per decidere se caricare la skill. Se
il `description` non contiene le frasi-trigger giuste, la skill non si attiva —
per quanto bello sia il corpo. Quindi:

- Scrivi COSA fa **e QUANDO** usarla, con **frasi-trigger concrete** ("quando
  l'utente chiede di X", "se vede un file `.yyy`", "prima di fare Z").
- Includi i sinonimi che un utente userebbe davvero, anche se non dice la parola
  "skill".
- Sii specifico: un router preciso si attiva al momento giusto e non a sproposito.

## Step (cosa fai quando questa skill si attiva)

1. **Chiarisci l'attività** da codificare: qual è il compito ripetitivo? Qual è
   l'input, qual è l'output atteso? Se non è chiaro, chiedi *una* domanda.
2. **Scegli il `name`**: kebab-case, breve, descrittivo (es. `crea-skill`).
3. **Scrivi il `description`** come router: 2–4 frasi-trigger concrete + cosa fa.
   Questa è la parte su cui spendere più tempo.
4. **Scrivi il corpo**: regole ("cosa fare / cosa NON fare", "read, don't guess",
   "non inventare: se manca un dato, dillo") e step numerati e azionabili.
5. **Crea il file** in `<nome-skill>/SKILL.md` (una cartella per skill).
6. **Verifica il trigger**: rileggi il `description` e chiediti "con quali frasi
   dell'utente questa skill si accende? e con quali NON dovrebbe accendersi?".

## Regole

- Il corpo dà istruzioni AZIONABILI, non teoria. Step numerati, non paragrafi.
- Cita evidenze reali quando la skill ispeziona qualcosa: file, righe, output.
  Mai inventare; se un dato non c'è, scrivi "non trovato".
- Una skill = un compito. Se ne stai mettendo tre, sono tre skill.

> Esempio "vero" da mostrare a confronto: la skill `talk-discovery` in
> `~/.claude/skills/talk-discovery/SKILL.md` — stesso schema, su un compito reale
> (fare l'audit di un repo per il talk). Guarda com'è scritto il suo
> `description`: è tutto trigger.