Come creare una skill di Claude su misura (con esempi)

Una skill è il modo per smettere di rispiegare a Claude come lavora la tua azienda ogni volta che apri una chat. Invece di incollare lo stesso prompt lunghissimo, lo impacchetti una volta sola — con le tue regole, il tuo tono, i tuoi esempi — e Claude lo richiama da solo quando serve. In questa guida ti mostro come creare una skill Claude dall’inizio alla fine, con un esempio reale e gli inciampi più comuni da evitare.

Se non hai ancora chiara la differenza tra un prompt e una skill, ti conviene partire da cosa sono le Skill di Claude e poi tornare qui: il resto dell’articolo dà per scontato che tu sappia, almeno a grandi linee, di cosa stiamo parlando.

Cosa serve prima di iniziare

La parte più importante di una skill non è tecnica. È la materia prima: i documenti reali che descrivono come fai le cose tu. Una skill costruita su un prompt generico produce risposte generiche; una skill costruita sui tuoi materiali produce risposte che sembrano scritte da una persona del tuo team.

Prima di toccare qualsiasi cosa, mettiti davanti queste tre cose:

• Esempi di output buoni. Tre o quattro preventivi, email, report o post che rappresentano lo standard a cui vuoi arrivare. Sono il riferimento più prezioso che hai.
• Le regole implicite. Quelle cose che “si sanno” in azienda ma non sono scritte da nessuna parte: come ti rivolgi al cliente, cosa non si dice mai, quali condizioni vanno sempre incluse.
• Il compito esatto. Una skill che fa una cosa sola, fatta bene, vale più di una skill che prova a fare tutto. Definisci il confine prima di scrivere.

L’anatomia di una skill

Tecnicamente, una skill di Claude è una cartella con un file di istruzioni in formato Markdown (il classico SKILL.md) ed eventualmente dei file di supporto: esempi, modelli, riferimenti. Non serve saper programmare. Il file di istruzioni è testo, scritto in italiano, organizzato in modo che Claude capisca quando usare la skill e come comportarsi quando la usa.

Le parti che contano davvero sono quattro:

• Nome e descrizione. Servono a Claude per capire da solo quando attivare la skill. Una descrizione vaga (“aiuta con i documenti”) fa sì che la skill non parta quasi mai o parta a sproposito. Una descrizione precisa (“genera preventivi per servizi di consulenza usando il listino aziendale”) la rende affidabile.
• Le istruzioni operative. Cosa deve fare Claude, in che ordine, con quale tono. Qui scrivi le regole implicite di cui sopra, trasformate in frasi chiare.
• Gli esempi. Mostrare vale più di spiegare. Un esempio di output corretto orienta Claude meglio di tre paragrafi di descrizione.
• I confini. Cosa la skill non deve fare. È la parte che le persone dimenticano e che evita i risultati imbarazzanti.

Creare una skill passo dopo passo

Ecco il metodo che uso io, ridotto all’osso. Funziona perché parte dal risultato e torna indietro, invece di partire dalla tecnologia.

1. Scegli un compito ripetitivo e noioso

Il candidato ideale è un’attività che fai spesso, che segue uno schema, e che ti porta via tempo senza darti soddisfazione. Preventivi, risposte standard, riassunti di riunioni, prime bozze di contenuti. Lascia perdere, per ora, i compiti creativi o strategici.

2. Raccogli tre esempi reali

Prendi tre output veri, di quelli che hai già fatto e che ti rappresentano. Non costruirli per l’occasione: gli esempi finti producono skill finte.

3. Scrivi le istruzioni come a un collega

Apri un documento e descrivi il compito come lo spiegheresti a una persona al primo giorno. “Quando arriva una richiesta di preventivo, prendi il servizio, applica il listino, aggiungi sempre la clausola sui tempi di consegna, usa un tono cordiale ma professionale.” Frasi semplici, una regola per riga.

4. Aggiungi le regole implicite

Rileggi e chiediti: “cosa darei per scontato che il collega non sa?”. Quelle cose vanno scritte. È qui che una skill smette di essere generica.

5. Definisci i confini

Scrivi cosa la skill non deve fare: non inventare prezzi, non promettere tempi che non puoi rispettare, non firmarsi a tuo nome. I divieti sono protezioni.

6. Collauda con casi veri

Dai alla skill tre richieste reali e guarda l’output con occhio critico. Dove sbaglia, non riscrivere la skill da capo: aggiusta una regola alla volta. Il collaudo è dove una skill mediocre diventa una skill di cui ti fidi.

Una skill non si scrive: si limita. Il primo giro è quasi sempre troppo lungo e troppo timido. I giri successivi tolgono il superfluo e aggiungono le regole che mancavano.

Un esempio completo: la skill “preventivi”

Immagina uno studio che riceve ogni settimana richieste di preventivo via email. Oggi qualcuno apre il template, copia, incolla, cambia i numeri a mano. Tipicamente sono dieci, quindici minuti a preventivo, più gli errori di distrazione.

La skill “preventivi” potrebbe contenere, in parole povere:

• Descrizione: “Genera la bozza di un preventivo a partire dalla richiesta del cliente, usando il listino dello studio e le condizioni standard.”
• Istruzioni: riconosci il servizio richiesto; applica la tariffa dal listino allegato; aggiungi sempre tempi di consegna, validità dell’offerta e modalità di pagamento; usa un’apertura cordiale e una chiusura che invita a fissare una call.
• Esempi: tre preventivi reali già inviati, così Claude impara la struttura e il tono.
• Confini: se il servizio non è a listino, non inventare il prezzo — segnala che serve una quotazione manuale.

Il risultato non è un preventivo da spedire a occhi chiusi. È una bozza solida, già nel tuo formato, che chi di dovere rilegge e invia. Il tempo passa da quindici minuti a due, e gli errori da distrazione spariscono. Trovi altri casi così nell’articolo con esempi di skill per le PMI.

Gli errori che vedo più spesso

Quando le persone provano a costruirsi una skill da sole, inciampano quasi sempre negli stessi punti:

• Skill che vogliono fare tutto. “Una skill che gestisce i clienti” non è una skill, è un reparto. Riduci finché non resta un compito solo.
• Descrizione vaga. Se Claude non capisce quando attivarla, la skill resta inutilizzata anche se è scritta bene.
• Nessun esempio. È l’errore più costoso. Senza esempi reali, Claude indovina lo stile — e indovina male.
• Niente confini. Senza divieti espliciti, prima o poi arriva l’output che ti fa storcere il naso davanti a un cliente.
• Saltare il collaudo. La prima versione non è mai quella buona. Chi non collauda finisce per non fidarsi della skill e tornare a fare tutto a mano.

Farla da soli o farsela costruire

Costruirsi la prima skill da soli è assolutamente possibile, e con il metodo qui sopra hai tutto quello che serve per provarci. È anche un ottimo modo per capire come ragiona Claude e prendere confidenza. Se vuoi approfondire come funzionano le Skill in azienda e quali si prestano meglio, la pagina di riferimento è il pillar sulle Skill di Claude.

Detto questo, c’è una differenza tra una skill che “funziona” e una skill di cui ti fidi al punto da metterla in mano al team. La seconda nasce quasi sempre da qualche giro di collaudo in più e dall’abitudine a tradurre i processi in regole. Se preferisci saltare la curva di apprendimento, è esattamente quello che faccio con Claude su Misura: partiamo dai tuoi documenti reali, progetto la skill, la collaudo e te la consegno pronta all’uso, a prezzo fisso.

Qualunque strada scegli, il principio resta lo stesso che ripeto sempre: prima i processi, poi l’automazione. Una skill costruita su un processo confuso eredita la confusione. Una skill costruita su un processo chiaro diventa un collaboratore stabile.