Come Creare una Skill per Claude Code da Zero: Guida Pratica con Esempi Reali

Aggiornato: marzo 2026

Probabilmente hai già sentito parlare delle skill di Claude Code. Forse ne hai letta qualcosa, forse hai visto che qualcuno le usa, ma non hai ancora capito perché vale la pena investirci del tempo.

Risposta breve: perché smetti di ripetere le stesse istruzioni ogni volta e inizi ad avere un assistente che ti conosce davvero.

In questo articolo spiego come costruirle, con esempi dal mio workflow reale, inclusi gli errori che ho fatto e quelli che ti conviene evitare.

Cosa Sono le Skill di Claude Code

Una skill di Claude Code è un file markdown con istruzioni strutturate che Claude esegue su richiesta, invocandola con /nome-skill dalla CLI. Permette di salvare un insieme di comportamenti, formati e contesti che altrimenti dovresti riscrivere ogni sessione. Non è un plugin, non è un API: è configurazione testuale portabile.

Esistono due tipi:

• Skill globali: disponibili in tutti i progetti, utili per attività personali ricorrenti (branding, preventivi, comunicazioni)
• Skill di progetto: specifiche per una tecnologia o per un cliente, attivate solo nel contesto in cui servono

La parola chiave è persistenza del contesto: la skill fa sì che Claude ti conosca già prima che tu apra la bocca.

Skill vs MCP: Qual È la Differenza e Quando Usare Quale

Una delle domande più frequenti è: quando usare una skill e quando usare un MCP (Model Context Protocol)?

La differenza si sta assottigliando. Oggi, per l'uso quotidiano, le skill da CLI sono più efficienti degli MCP nella maggior parte dei casi. Ho costruito un MCP per VTENext CRM che espone le API in linguaggio naturale, e ha senso in quel contesto. Ma per personalizzare il workflow, la skill batte l'MCP in efficienza. La mia previsione è che le skill di una CLI sostituiranno molti MCP nei casi d'uso comuni nel breve futuro.

Quando Vale la Pena Creare una Skill

La risposta che mi sono dato dopo mesi di utilizzo: quando senti la necessità di istruire il tuo assistente personale, ovvero avere qualcuno che a memoria ti conosce.

Il segnale pratico è più semplice: se ti ritrovi a ripetere le stesse istruzioni a Claude tre volte o più, quella è una skill che non hai ancora scritto.

Non si tratta di automatizzare per il gusto di farlo. Si tratta di non sprecare contesto (e tempo) a rispiegare ogni volta chi sei, come lavori, che formato vuoi, quali vincoli hai.

Come Ho Iniziato: Dal Branding ai Preventivi

La prima skill che ho costruito riguardava il branding di Castaldo Solutions: font, colori, tono di voce, target, payoff. Tutto quello che serve a Claude per produrre comunicazioni coerenti senza doverlo specificare ogni sessione.

Il risparmio era già concreto: ogni prompt per DALL-E o post LinkedIn partiva dal contesto giusto, senza ricominciare da zero.

Ma il salto di valore vero è arrivato con la skill per i preventivi.

I preventivi per i clienti seguono sempre la stessa struttura: un documento Word con sezioni definite e formattazione precisa. Prima della skill, ogni volta dovevo ripartire da un template manuale o rispiegare a Claude come volevo il file. Con la skill, Claude conserva il codice base del documento e lo applica automaticamente a ogni nuovo preventivo. Basta passare i dati del cliente e il contesto del progetto. Quello è stato il momento in cui ho capito quanto fosse potente lo strumento.

Stima del risparmio: ogni ora investita nella costruzione di una skill ne risparmia almeno dieci nel breve termine.

Come Si Costruisce una Skill in 3 Passi

Passo 1: Definisci l'output prima di tutto

Quali asset deve produrre la skill? In che formato? Con quali vincoli? Se non hai chiarezza su questo, le istruzioni risulteranno vaghe e l'output sarà incoerente. È esattamente come quando istruisci un collaboratore: se non sai cosa vuoi, non puoi spiegarglielo.

Passo 2: Scrivi istruzioni senza contraddizioni

Ogni regola deve essere coerente con le altre. Se scrivi "usa sempre un tono formale" e poi "dai del tu", stai già creando confusione. Rileggi la skill come se dovessi interpretarla tu stesso, senza contesto aggiuntivo.

Passo 3: Testa, misura i token, itera

Questo è il passo che quasi tutti saltano. Una skill mal costruita non produce solo output scadente: erode il contesto della conversazione, accelerando il context rot (vedi sezione successiva). Testa l'output, verifica quanti token consuma la skill, elimina tutto quello che non è strettamente necessario.

Tempo medio: 1 ora per una skill funzionante con le idee chiare. 3 ore o più con iterazioni e raffinamenti.

Come Usare lo skill-creator per Costruire Skill Velocemente

Il metodo più efficiente per costruire una skill da zero è usare lo skill-creator integrato in Claude Code, che sfrutta la modalità cowork.

Ecco come funziona:

1. Descrivi a Claude la skill che vuoi costruire
2. Claude avvia un processo multi-agente: crea 3 agenti separati con approcci diversi
3. Confronta i risultati e ti chiede feedback su cosa funziona
4. In 2 cicli di iterazione, ottieni una skill completa impacchettata in un file .skill installabile

Non sei uno spettatore: sei parte attiva del processo. Il risultato rispecchia esattamente il tuo modo di lavorare, non un template generico. Questo è il modo consigliato per chi parte.

Cos'è il Context Rot e Come le Skill Mal Costruite lo Accelerano

Il context rot è il degrado progressivo della qualità di una conversazione AI man mano che il contesto si riempie.

Definizione tecnica: ogni sessione con Claude ha una finestra di contesto limitata (la "memoria" attiva della conversazione). Quando si avvicina al limite, le informazioni più vecchie vengono compresse o perdono influenza sulle risposte. Claude inizia a dimenticare le istruzioni iniziali, produce output meno coerenti, e la qualità degrada in modo percettibile anche nel corso di una stessa sessione di lavoro.

Le skill mal costruite accelerano questo fenomeno in modo significativo. Se una skill è piena di informazioni ridondanti, asset non necessari o istruzioni verbose, ogni invocazione consuma una fetta di contesto che non recuperi.

La regola pratica: ogni informazione dentro una skill deve guadagnarsi il suo posto. Se puoi toglierla senza perdere qualità nell'output, toglila.

Misura i token prima e dopo ogni revisione. Non è un dettaglio tecnico: è la differenza tra una skill che funziona per un'intera sessione e una che degrada dopo venti minuti.

Le Skill per le Aziende: Non Solo Uso Personale

Le skill non sono uno strumento solo per chi lavora da solo.

In Castaldo Solutions le stiamo costruendo per tutti i clienti che aderiscono ai nostri programmi di AI Adoption. Non si tratta di consegnare un tool: si tratta di trasferire un modo di lavorare. La skill diventa un asset del cliente, qualcosa che porta con sé nel tempo e che può evolvere insieme al suo workflow.

L'AI non si "usa", si configura. E le skill sono uno degli strumenti più diretti per farlo.

Domande Frequenti sulle Skill di Claude Code

Cosa serve per creare una skill di Claude Code? Solo un editor di testo e Claude Code installato. La skill è un file markdown che salvi in ~/.claude/skills/ (globale) o in .claude/skills/ dentro il progetto (locale). Nessuna installazione aggiuntiva, nessun server.

Le skill di Claude funzionano anche con altri modelli AI? Le skill nel formato Claude Code sono specifiche per Claude. Tuttavia il concetto è stato adottato anche da altri tool: OpenAI ha introdotto strutture analoghe in ChatGPT e Codex CLI, mirroring il formato Anthropic.

Quanto contesto consuma una skill? Dipende dalla dimensione del file. Una skill ben costruita pesa tra 500 e 2.000 token. Skill mal ottimizzate possono superare i 5.000 token per invocazione, accelerando il context rot già nelle prime ore di utilizzo.

È possibile condividere o installare skill create da altri? Sì. Le skill possono essere distribuite come file .skill installabili, esattamente come pacchetti. Castaldo Solutions le distribuisce ai propri clienti nei programmi di AI Adoption come asset configurato sul loro workflow specifico.

Qual è la differenza tra una skill e un CLAUDE.md? Il file CLAUDE.md fornisce contesto persistente sul progetto a Claude in ogni conversazione. Una skill è un comando attivo: viene invocata esplicitamente con /nome-skill e contiene istruzioni operative per produrre un output specifico. I due strumenti si complementano.

Da Dove Partire: Il Consiglio

Se dovessi darti un solo consiglio: apri lo skill-creator e descrivili cosa fai ogni giorno.

Non serve un piano dettagliato, non serve capire tutto prima. Parti da un'attività che ripeti spesso e costruisci la prima skill intorno a quella. Il processo di costruzione ti insegnerà più di qualsiasi guida.

Vuoi capire se la tua azienda è pronta per adottare questi strumenti in modo strutturato? Parti da una conversazione con noi.

Prenota un pre-assessment gratuito