Claude Skills: la guida completa per creare competenze personalizzate per il tuo ecommerce

Se lavori nell’ecommerce, probabilmente hai già scoperto che un assistente AI generativo può aiutarti a scrivere schede prodotto, rispondere ai clienti, preparare report o abbozzare contenuti per i social. Il problema, però, è un altro: ogni volta che apri una nuova chat devi ripetere daccapo lo stesso contesto. Il tono di voce del brand. Le regole di formattazione delle schede prodotto. I dati che il commercialista vuole vedere nei report mensili. Le policy di reso da citare nelle risposte del customer care. Cinque minuti spesi a “rieducare” l’assistente, ogni singola volta.

Claude, l’assistente sviluppato da Anthropic, ha una funzione pensata proprio per risolvere questo problema: le Skill, o “competenze”. Sono pacchetti di istruzioni che Claude richiama da solo quando servono, così il contesto che oggi ripeti a ogni conversazione diventa qualcosa che scrivi una volta sola e che resta a disposizione. In questa guida vediamo, con ordine, cos’è Claude, cosa sono davvero le Skill, perché possono essere utili a chi gestisce un negozio online e soprattutto come costruirne una da zero, passo dopo passo.

Una piccola premessa: cos’è Claude

Claude è la famiglia di modelli di intelligenza artificiale sviluppata da Anthropic, pensata per essere un assistente conversazionale capace di scrivere, ragionare, analizzare dati, generare codice e produrre documenti. Non è un motore di ricerca e non è un semplice generatore di testo a completamento automatico: è un modello che tiene conto del contesto della conversazione, segue istruzioni articolate su più passaggi e può usare strumenti esterni dalla ricerca sul web alla creazione di file Word, Excel o PowerPoint, fino alla connessione con servizi come Gmail, Google Drive o piattaforme di ecommerce come Shopify.

Puoi usare Claude attraverso diversi canali: l’app web e mobile di claude.ai, pensata per l’uso quotidiano da parte di privati e professionisti; l’API, che permette agli sviluppatori di integrare Claude dentro applicazioni e flussi di lavoro personalizzati; e Claude Code, uno strumento pensato per chi scrive software e vuole delegare a Claude interi task di programmazione da riga di comando o da editor.

Un aspetto che distingue Claude da un semplice motore di completamento testuale è la capacità di lavorare con strumenti esterni durante una singola conversazione: può cercare informazioni aggiornate sul web, leggere e scrivere file, eseguire codice per elaborare dati reali (non solo descriverli a parole) e, tramite i connettori MCP, collegarsi a servizi che già usi ogni giorno la posta elettronica, il calendario, i documenti su Google Drive, la piattaforma che gestisce il tuo store online. Questo significa che una richiesta come “controlla lo stato di questo ordine e prepara una risposta per il cliente” non è più fantascienza: è un flusso che Claude può eseguire da cima a fondo, se gli hai dato accesso agli strumenti giusti.

Per chi gestisce un ecommerce, il punto interessante non è tanto la potenza del modello in sé quella si dà ormai per scontata quanto la possibilità di personalizzarlo in modo persistente, senza dover ogni volta ricostruire il contesto aziendale da zero. Ed è esattamente qui che entrano in gioco le Skill.

Cosa sono le Skill di Claude

Una Skill è, nella sua forma più semplice, una cartella contenente istruzioni scritte in linguaggio naturale (in un file chiamato SKILL.md ) che Claude legge e applica quando riconosce che il compito richiesto rientra in quella competenza. Le Skill possono essere semplici come poche righe di testo ad esempio “quando scrivi una scheda prodotto per il nostro store, usa questo tono di voce e questa struttura” oppure complesse, con più file di riferimento, script eseguibili e dipendenze software dichiarate.

Il meccanismo che le rende utili si chiama divulgazione progressiva (progressive disclosure). Funziona così: all’avvio di ogni conversazione, Claude carica solo i metadati di tutte le Skill disponibili cioè nome e descrizione, non il contenuto completo. Quando ricevi una richiesta che sembra corrispondere a una di queste descrizioni, Claude carica il corpo completo delle istruzioni di quella specifica Skill, e solo di quella. Se la Skill rimanda a ulteriori file di riferimento (una checklist lunga, un elenco di codici prodotto, un manuale di stile più esteso), anche quelli vengono caricati solo se e quando servono davvero.

Questo approccio a strati ha un vantaggio pratico enorme: puoi avere decine di Skill attive senza appesantire ogni conversazione con informazioni che, quella volta, non ti servono. È una differenza sostanziale rispetto a incollare tutto il tuo manuale operativo in ogni prompt: con le Skill, il contesto entra in gioco solo quando è pertinente.

Perché il “peso” di una Skill conta

Vale la pena capire perché questo meccanismo esiste, perché influenza direttamente come dovresti scrivere le tue Skill. La finestra di contesto di Claude lo spazio entro cui il modello può “vedere” informazioni durante una conversazione è una risorsa condivisa: ci deve stare la cronologia della chat, i documenti che hai caricato, le istruzioni di sistema e, appunto, il contenuto delle Skill rilevanti. Se ogni Skill caricasse per intero il proprio contenuto fin dal primo istante, avere più di due o tre competenze attive diventerebbe rapidamente costoso e rallenterebbe le risposte. La divulgazione progressiva risolve il problema separando “sapere che una Skill esiste” (economico: solo nome e descrizione) da “usarne davvero il contenuto” (più corposo, ma attivato solo quando serve). È anche per questo che una descrizione precisa nel frontmatter non è un dettaglio stilistico: è ciò che permette a Claude di scartare in fretta le Skill non pertinenti senza doverne caricare il contenuto per verificarlo.

Esistono quattro categorie di Skill:

• Skill di Anthropic: create e mantenute direttamente da Anthropic, disponibili per tutti gli utenti e richiamate automaticamente quando pertinenti. Rientrano qui, ad esempio, le competenze per la creazione avanzata di documenti Word, Excel, PowerPoint e PDF.
• Skill personalizzate: quelle che crei tu (o la tua azienda) per flussi di lavoro specifici del tuo dominio il caso che ci interessa in questa guida.
• Skill fornite dall’organizzazione: per i piani Team ed Enterprise, chi amministra l’account può distribuire Skill a tutti i membri del team, impostandole come attive o disattive di default.
• Skill dei partner: competenze costruite professionalmente da aziende terze (Notion, Figma, Atlassian e altre), pensate per funzionare insieme ai rispettivi connettori, e disponibili in una directory dedicata.

Le Skill sono disponibili sui piani Free, Pro, Max, Team ed Enterprise di Claude, a condizione che l’esecuzione del codice sia abilitata nelle impostazioni. Sono inoltre disponibili in versione beta per chi usa Claude Code e per gli utenti dell’API che sfruttano lo strumento di esecuzione del codice.

Skill, Progetti, MCP e istruzioni personalizzate: le differenze

Se hai già usato Claude, probabilmente conosci altre funzioni che sembrano fare cose simili. Vale la pena chiarire subito le differenze, perché scegliere lo strumento sbagliato è l’errore più comune tra chi comincia.

Skill contro Progetti. I Progetti di Claude forniscono una base di conoscenza statica che viene caricata per intero a ogni chat aperta al loro interno utile per tenere insieme documenti, contesto e conversazioni relative, ad esempio, al lancio di una nuova collezione. Le Skill, invece, forniscono procedure specializzate che si attivano dinamicamente solo quando servono, e funzionano ovunque tu stia usando Claude, non solo dentro un progetto specifico. Se hai bisogno di un archivio di riferimento sempre presente, usa un Progetto; se hai bisogno di una procedura che si attiva solo per un certo tipo di compito, usa una Skill.

Skill contro MCP. Il Model Context Protocol (MCP) collega Claude a servizi esterni e a fonti dati la tua casella Gmail, il tuo Google Drive, il tuo store Shopify, il tuo gestionale. Le Skill, al contrario, non collegano nulla: forniscono conoscenza procedurale, cioè istruzioni su come portare a termine un compito. I due strumenti si completano: un connettore MCP dà a Claude l’accesso ai tuoi dati Shopify, mentre una Skill può insegnargli come usare quei dati seguendo le convenzioni della tua azienda (ad esempio, come strutturare la risposta quando un cliente chiede lo stato di un ordine).

Skill contro istruzioni personalizzate. Le istruzioni personalizzate (o “stili”, funzione che si sta progressivamente spostando proprio verso le Skill) si applicano in modo ampio a tutte le tue conversazioni, indipendentemente dall’argomento. Le Skill sono specifiche per compito: si caricano solo quando la richiesta corrisponde alla loro descrizione, il che le rende più adatte a flussi di lavoro specializzati che non vuoi che interferiscano con tutto il resto.

Capita spesso che chi comincia provi a costruire un’unica mega-Skill che fa tutto dal tono di voce alla gestione dei resi, passando per la reportistica. È quasi sempre un errore: Skill più piccole e mirate si compongono meglio tra loro (Claude può usarne più di una nella stessa richiesta, in automatico) rispetto a un’unica competenza sovraccarica.

Per rendere concreta la differenza, immagina di dover lanciare una nuova collezione stagionale. Il Progetto raccoglie tutto il materiale specifico di quel lancio brief, moodboard, calendario editoriale e resta a disposizione per l’intera durata della campagna. Le Skill che usi dentro quel progetto restano invece quelle di sempre: la Skill per le schede prodotto continuerà ad applicare lo stesso tono di voce e la stessa struttura, indipendentemente dal fatto che tu stia lavorando dentro quel progetto specifico o in una chat qualsiasi. Il connettore MCP verso il tuo store, infine, è ciò che permette a Claude di verificare, mentre lavora sul lancio, se un determinato SKU è già stato caricato a catalogo. Tre strumenti, tre compiti distinti, che nella pratica lavorano insieme senza sovrapporsi.

Perché un ecommerce dovrebbe creare una Skill

Il criterio più semplice per capire se un flusso di lavoro merita una Skill è questo: se ti accorgi di ripetere le stesse istruzioni tre volte o più, quella è una Skill che non hai ancora scritto. Ecco alcuni casi concreti, pensati per chi gestisce un negozio online.

Schede prodotto coerenti con il brand. Ogni volta che carichi un nuovo prodotto, probabilmente vuoi una descrizione che segua una struttura precisa: lunghezza, parole chiave SEO da includere, termini da evitare (magari il tuo brand non usa mai la parola “economico”, preferisce “accessibile”), formato per taglie e materiali. Una Skill dedicata elimina la necessità di spiegarlo ogni volta.

Risposte al customer care. Le policy di reso, i tempi di spedizione, il tono con cui rispondere a un cliente insoddisfatto: tutto materiale che si presta perfettamente a una Skill, così che ogni bozza di risposta generata da Claude rispetti automaticamente le regole aziendali.

Reportistica periodica. Se ogni mese prepari lo stesso tipo di report per il commercialista o per la proprietà stessi campi, stessa struttura, stesse metriche da evidenziare una Skill può incapsulare quel formato una volta per tutte.

Contenuti per i social e le newsletter. Tono di voce, hashtag ricorrenti, call-to-action standard, lunghezza dei post per ogni piattaforma: anche qui, invece di ripetere il brief a ogni richiesta, lo scrivi una volta nella Skill.

Automazione dei processi interni. Strutturare gli appunti di una riunione secondo un template aziendale, creare task su strumenti come Jira, Asana o Linear seguendo le convenzioni del team, eseguire flussi di analisi dati specifici della tua organizzazione: sono tutti esempi di flussi di lavoro che le Skill personalizzate possono automatizzare.

Traduzione e localizzazione dei contenuti. Se vendi anche all’estero, probabilmente hai regole non scritte su come adattare le schede prodotto ai vari mercati: unità di misura, taglie locali, riferimenti culturali da evitare, valute. Una Skill dedicata alla localizzazione può incapsulare queste regole per ciascun mercato, evitando che ogni traduzione parta da zero.

Gestione delle recensioni. Rispondere alle recensioni positive, neutre o negative richiede un registro diverso a seconda del caso, ma sempre coerente con l’immagine del brand. Una Skill può definire come rispondere a una recensione a una stella (riconoscere il problema, offrire un canale diretto per risolverlo, mai giustificarsi in modo difensivo) e come farlo per una recensione a cinque stelle (ringraziare senza essere sdolcinati, invitare a condividere la propria esperienza).

Analisi dei dati di vendita. Se ogni settimana analizzi le stesse metriche tasso di conversione per categoria, prodotti col carrello abbandonato più alto, andamento del reso per fornitore una Skill può contenere le definizioni esatte di questi indicatori e il formato in cui vuoi vederli presentati, così da ottenere analisi comparabili nel tempo invece di report che cambiano struttura ogni volta che li richiedi.

Il vantaggio, in tutti questi casi, non è solo il risparmio di tempo nello scrivere il prompt. È soprattutto la coerenza: con una Skill ben scritta, ogni collaboratore che usa Claude per quel compito otterrà risultati allineati agli standard aziendali, senza dover ricordare a memoria le regole o andarle a recuperare da un documento condiviso sperando che qualcuno lo abbia letto per intero.

L’anatomia di una Skill: il file SKILL.md

Ogni Skill è, tecnicamente, una directory che contiene almeno un file chiamato SKILL.md . Questo file è il cuore della competenza e ha una struttura precisa.

Il frontmatter: i metadati obbligatori

Il file deve iniziare con un blocco di metadati in formato YAML, racchiuso tra righe di tre trattini ( --- ). Due campi sono obbligatori:

• name: il nome della Skill, fino a 64 caratteri. Deve essere descrittivo ad esempio “Schede Prodotto Brand X” piuttosto che “Skill1”.
• description: la descrizione di cosa fa la Skill e quando va usata, fino a 200 caratteri. Questo è il campo più importante di tutti, perché è ciò che Claude confronta con la tua richiesta per decidere se attivare la competenza. Una descrizione vaga produce una Skill che non si attiva mai, o che si attiva nei momenti sbagliati.

Un campo facoltativo comune è dependencies, con cui dichiari eventuali pacchetti software richiesti dalla Skill (ad esempio librerie Python per elaborare un file Excel).

Il corpo Markdown

Dopo il frontmatter, il resto del file è markdown libero: qui scrivi le istruzioni vere e proprie. È il secondo livello della divulgazione progressiva Claude lo legge solo dopo aver deciso, in base ai metadati, che la Skill è pertinente. Puoi strutturarlo come preferisci, ma un buono schema di partenza è: una panoramica di cosa fa la competenza, le regole specifiche da seguire, esempi di input e output, e un’indicazione di quando applicarla.

File di risorsa aggiuntivi

Se il contenuto necessario è troppo per stare comodamente in un unico file, puoi aggiungere altri file markdown alla cartella (ad esempio linee-guida-brand.md o elenco-categorie.md ) e richiamarli dal file principale. Claude deciderà da solo se e quando aprirli, in base a cosa richiede il compito specifico così il file principale resta snello.

Script eseguibili

Per Skill più avanzate puoi allegare codice eseguibile: le competenze di Anthropic per la creazione di documenti, ad esempio, usano internamente Python (con librerie come pandas, numpy o matplotlib), JavaScript/Node.js e strumenti dedicati alla manipolazione di file. Su claude.ai e Claude Code, Claude può installare pacchetti da repository standard (PyPI per Python, npm per JavaScript) e scaricare risorse da repository GitHub nel momento in cui la Skill viene caricata. Con l’API, invece, non c’è accesso di rete a runtime: tutte le dipendenze vanno preinstallate nel container, ed è per questo che conviene elencarle esplicitamente nel file SKILL.md.

Le Skill girano in un ambiente di esecuzione del codice con accesso al filesystem, a comandi bash e alla possibilità di eseguire codice: è lo stesso ambiente che rende possibile, ad esempio, generare un file Excel con formule funzionanti invece di un semplice elenco di numeri in una tabella.

Organizzare Skill con più file

Man mano che una Skill cresce, vale la pena separare il file principale dai contenuti più corposi. Un pattern comune, ripreso anche nelle competenze ufficiali di Anthropic per la creazione di documenti, è tenere SKILL.md snello poche decine di righe che spiegano l’essenziale e spostare i dettagli pesanti (un lungo elenco di categorie merceologiche, una guida di stile estesa, un catalogo di esempi) in file separati richiamati dal principale solo quando servono. Il vantaggio non è solo estetico: significa che puoi avere Skill molto ricche di dettaglio senza che quel dettaglio pesi sulla finestra di contesto in ogni singola conversazione, perché viene caricato solo quando il compito lo richiede davvero.

Guida pratica: crea la tua prima Skill passo dopo passo

Vediamo ora un esempio concreto, costruendo insieme una Skill pensata per generare schede prodotto coerenti con lo stile di un negozio online immaginario.

Passo 1 Definisci lo scope

Prima ancora di scrivere una riga, decidi cosa la Skill deve fare e cosa no. Una Skill efficace risolve un compito specifico e ripetibile, non “tutto il marketing dell’azienda”. Nel nostro esempio: “genera la descrizione di un prodotto per lo store online, a partire da nome, categoria e caratteristiche tecniche fornite dall’utente”.

Un consiglio che vale la pena seguire fin da subito: prima di scrivere documentazione estesa, prova a far lavorare Claude sullo stesso compito senza alcuna Skill, con un prompt normale. Annota che cosa hai dovuto spiegare a mano, quali dettagli hai fornito ripetutamente, dove Claude ha sbagliato tono o struttura. Quello che hai appena annotato è, in pratica, la prima bozza della tua Skill: stai risolvendo un problema reale invece di documentare regole che forse non serviranno mai.

Questo passaggio, per quanto possa sembrare superfluo quando l’entusiasmo spinge a scrivere subito, evita l’errore opposto e altrettanto comune: costruire una Skill molto dettagliata basata su ipotesi di cosa “potrebbe servire”, che poi nella pratica si rivela sbagliata o incompleta rispetto ai casi reali. Meglio partire piccoli e osservare, piuttosto che indovinare.

Passo 2 Crea la cartella e il file SKILL.md

Crea una cartella con un nome coerente con la competenza (ad esempio schede-prodotto-store ) e al suo interno un file SKILL.md . Ecco una bozza plausibile:

---
name: Schede Prodotto Store
description: Genera descrizioni prodotto per il nostro ecommerce nel tono di voce del brand, con struttura fissa e parole chiave SEO. Usa questa competenza quando l'utente chiede di scrivere o rivedere una scheda prodotto per lo store.
---
## Struttura della scheda
Ogni scheda prodotto deve contenere, in quest'ordine:
1. Un titolo di massimo 60 caratteri, con la parola chiave principale all'inizio.
2. Un paragrafo introduttivo di 2-3 frasi che comunichi il beneficio principale, non solo le caratteristiche tecniche.
3. Un elenco puntato con le caratteristiche tecniche (materiali, misure, compatibilità).
4. Una chiusura breve con invito all'azione soft (non "compra ora", piuttosto "scopri di più" o simili).
## Tono di voce
- Diretto e amichevole, mai formale o distaccato.
- Frasi brevi, massimo 20-25 parole.
- Evita superlativi generici come "il migliore" o "unico nel suo genere" senza un dato a supporto.
- Non usare mai la parola "economico": preferisci "accessibile" o "conveniente".
## Parole chiave da includere quando pertinenti
Fai una breve ricerca (se disponibile) o chiedi all'utente le parole chiave principali della categoria prodotto, e inseriscine almeno una nel titolo e una nel primo paragrafo.
## Esempio di output atteso
Titolo: "Zaino porta laptop 15'' impermeabile e leggero"
Corpo: descrizione breve del beneficio (proteggere il laptop in ogni condizione), elenco caratteristiche (materiale, tasche, compatibilità), chiusura con invito soft.

Nota come la descrizione nel frontmatter sia specifica: dice esattamente cosa fa la Skill e quando va usata. È il dettaglio che più spesso fa la differenza tra una Skill che si attiva quando serve e una che Claude ignora.

Passo 3 Aggiungi materiale di riferimento, se necessario

Se il tuo manuale di stile è più corposo ad esempio contiene decine di esempi, o un elenco di categorie merceologiche con regole diverse per ciascuna non incollarlo tutto nel file principale. Creane uno separato (ad esempio linee-guida-dettagliate.md ) e aggiungi, nel corpo di SKILL.md , una riga che lo richiami, così Claude saprà di poterlo consultare quando il compito lo richiede.

Passo 4 Testa prima di caricare

Prima di caricare la Skill su Claude, rileggi il file con occhio critico: la descrizione riflette davvero quando la competenza dovrebbe attivarsi? Tutti i file richiamati esistono nei percorsi corretti? Prova mentalmente due o tre richieste tipiche e chiediti se, leggendo solo nome e descrizione, capiresti che quella Skill è pertinente.

Un secondo esempio: la Skill per il customer care

Lo stesso procedimento vale per qualsiasi altro flusso di lavoro ripetitivo. Prendiamo il caso del customer care, dove la posta in gioco la soddisfazione di un cliente già scontento rende ancora più importante la coerenza del tono. Una bozza di SKILL.md per questo caso potrebbe assomigliare a questa:

---
name: Risposte Customer Care Store
description: Redige bozze di risposta alle email e ai messaggi dei clienti del nostro store, seguendo le policy ufficiali su resi, spedizioni e rimborsi. Usa questa competenza quando l'utente chiede di rispondere a un cliente o di redigere una comunicazione di assistenza.
---
## Regole generali
- Riconosci sempre il problema del cliente nella prima frase, prima di spiegare la procedura.
- Non usare mai linguaggio difensivo o che scarichi la responsabilità sul cliente.
- Chiudi ogni risposta con un passo concreto e una scadenza, quando applicabile ("riceverai il rimborso entro 5 giorni lavorativi").
## Policy da rispettare
- Reso: 30 giorni dalla consegna, prodotto non usato e nella confezione originale.
- Spedizione: 2-4 giorni lavorativi in Italia, 5-8 per il resto d'Europa.
- Rimborsi: elaborati entro 5 giorni lavorativi dalla ricezione del reso.
## Casi particolari
Se il cliente segnala un prodotto difettoso, proponi sempre la sostituzione gratuita come prima opzione, il rimborso solo se il cliente lo richiede esplicitamente o se il prodotto non è più disponibile.
Se il tono del messaggio del cliente è molto acceso, non rispecchiarlo: mantieni un registro calmo e concreto, senza minimizzare la frustrazione espressa.

Nota come questa Skill non richieda alcuno script: è puro testo, eppure incapsula in modo affidabile decisioni che altrimenti resterebbero nella testa di chi gestisce il servizio clienti da anni, e che un nuovo collaboratore impiegherebbe settimane ad assorbire.

Collegare le Skill ai tuoi strumenti reali: il ruolo di MCP

Le Skill diventano ancora più utili quando si combinano con i connettori MCP di cui abbiamo parlato in precedenza. Da sole, le Skill insegnano a Claude come fare qualcosa; i connettori MCP gli danno accesso ai dati con cui farlo davvero.

Un esempio concreto: se colleghi Claude al tuo store Shopify tramite il relativo connettore, puoi chiedere di recuperare lo stato di un ordine specifico o l’elenco degli ultimi prodotti aggiunti al catalogo. Se in parallelo hai una Skill che definisce come strutturare le risposte al customer care, Claude può combinare le due cose in automatico: recuperare i dati reali dell’ordine dal tuo store e usarli per redigere una risposta che rispetta il tono e le policy definite nella Skill, senza che tu debba spiegare ogni volta entrambe le cose separatamente.

Lo stesso vale per Gmail o Google Drive: un connettore ti dà accesso alla posta o ai documenti, mentre una Skill definisce come vuoi che Claude si comporti quando lavora su quei dati che formato dare a un riepilogo, quali informazioni includere, quale tono usare. Skill e connettori, in altre parole, rispondono a due domande diverse ma complementari: “a cosa ho accesso” e “come mi comporto quando ci lavoro”.

Come impacchettare e caricare la Skill su Claude

Una volta pronta la cartella, il passaggio successivo dipende da dove userai la Skill.

Su claude.ai (l’app web o mobile):

1. Assicurati che il nome della cartella corrisponda esattamente al nome della Skill.
2. Comprimi la cartella in un file ZIP. Attenzione alla struttura: lo ZIP deve contenere la cartella della Skill come radice, non i file sparsi direttamente dentro lo ZIP né una sotto-cartella annidata in più.
3. Vai su Personalizza > Competenze nel tuo account Claude e carica lo ZIP.
4. Abilita la Skill dalla stessa schermata.

Su Claude Code: le Skill vanno salvate come cartelle contenenti un file SKILL.md dentro ~/.claude/skills/ per le competenze personali, disponibili su tutti i tuoi progetti, oppure dentro .claude/skills/ alla radice del repository per le competenze di progetto, condivise via git con il team. Non serve alcuna installazione aggiuntiva: Claude Code effettua la scansione di entrambe le posizioni all’avvio.

Per i piani Team ed Enterprise: chi amministra l’organizzazione può rendere una Skill disponibile automaticamente a tutti i membri del team, impostandola come attiva o disattiva di default, senza che ogni singola persona debba caricarla a mano.

Questo aspetto merita un approfondimento, perché è dove le Skill smettono di essere un trucchetto individuale e diventano infrastruttura aziendale. Se gestisci un ecommerce con più persone che usano Claude un addetto al customer care, chi cura il catalogo, chi si occupa di marketing puoi costruire un piccolo repertorio di Skill condivise: una per il tono di voce del brand, una per le policy di reso, una per il formato dei report. Distribuendole a livello di organizzazione, ottieni due vantaggi concreti: primo, chi si aggiunge al team eredita automaticamente le convenzioni aziendali senza bisogno di un briefing lungo; secondo, se una policy cambia (un nuovo fornitore di spedizioni, tempi di reso diversi), basta aggiornare la Skill una sola volta perché il cambiamento si propaghi a tutti, invece di rincorrere ogni singola persona che nel frattempo ha imparato la versione vecchia a memoria. È, di fatto, un modo di codificare la conoscenza istituzionale dell’azienda in una forma che Claude può applicare in modo coerente, invece di lasciarla dispersa tra documenti condivisi, messaggi Slack e abitudini tramandate a voce.

Testare e affinare la Skill

Caricare la Skill è solo l’inizio. Il vero lavoro comincia dopo, con l’iterazione:

• Prova diversi prompt che dovrebbero attivare la competenza, e alcuni che non dovrebbero, per verificare che i confini siano quelli attesi.
• Se l’interfaccia lo consente, guarda il ragionamento di Claude per confermare che la Skill è stata effettivamente caricata e applicata.
• Se Claude non richiama la Skill quando ti aspetteresti che lo faccia, il problema è quasi sempre nella descrizione: rendila più specifica su “quando” usarla, non solo su “cosa” fa.
• Quando stai perfezionando una Skill direttamente in chat, puoi modificarne i file nel pannello che si apre accanto alla conversazione: seleziona il testo da cambiare, chiedi a Claude di modificarlo, e se la Skill ha più file puoi lasciare richieste di modifica in ciascuno e applicarle tutte insieme in un solo passaggio.
• Testa in modo incrementale: dopo ogni cambiamento significativo, non aspettare di aver costruito l’intera competenza prima di provarla.

Un metodo più rigoroso, utile se la Skill è destinata a un uso intensivo o a tutto il team, è costruire delle vere e proprie valutazioni prima ancora di scrivere documentazione estesa: fai eseguire a Claude alcuni compiti rappresentativi senza la Skill, documenta i fallimenti specifici, costruisci tre scenari di test basati su quelle lacune, misura la prestazione di base, scrivi solo le istruzioni minime necessarie a superare quei test, poi itera confrontando i risultati con la baseline iniziale. È un approccio più lento ma garantisce che la Skill risolva problemi reali invece di anticipare esigenze che forse non si presenteranno mai.

Sicurezza: cosa non mettere mai in una Skill

Le Skill possono includere script eseguibili, ed è qui che serve un minimo di prudenza, soprattutto se la Skill verrà condivisa con altre persone del team o scaricata da fonti esterne:

• Non inserire mai chiavi API, password o altre credenziali direttamente nel testo della Skill: se un flusso di lavoro richiede l’accesso a un servizio esterno, usa una connessione MCP appropriata, non una credenziale scritta in chiaro.
• Rivedi sempre il contenuto di qualsiasi Skill scaricata da fonti terze prima di abilitarla, allo stesso modo in cui non installeresti un’estensione del browser senza controllarne i permessi.
• Se la Skill contiene script, considera che verranno eseguiti nell’ambiente di Claude: mantieni il codice semplice e comprensibile, evitando dipendenze non necessarie.

Uno standard aperto: Agent Skills

Un dettaglio che vale la pena conoscere: il formato delle Skill non è proprietario di Claude. La specifica si chiama Agent Skills ed è pubblicata come standard aperto (consultabile su agentskills.io), con tanto di SDK Python di riferimento per chi sviluppa supporto alle Skill su altre piattaforme. In pratica, se scrivi una Skill seguendo queste linee guida, quel lavoro non resta bloccato dentro un solo prodotto: lo stesso formato può, in linea di principio, funzionare su altri strumenti AI che adottano lo stesso standard. Per un’azienda che investe tempo nel costruire un patrimonio di competenze personalizzate, è una garanzia di portabilità non da poco.

Errori comuni da evitare

Da quanto emerge nell’uso pratico delle Skill, alcuni errori tornano più spesso di altri:

• Descrizioni troppo generiche. “Aiuta con l’ecommerce” non dice a Claude nulla di utile su quando intervenire. Meglio essere specifici: cosa fa, per chi, in quale situazione.
• Una Skill che vuole fare tutto. Come accennato, è quasi sempre meglio spezzare un flusso di lavoro complesso in più Skill mirate, che si compongono automaticamente, piuttosto che costruirne una monolitica.
• Saltare la fase di test. Caricare una Skill e non verificarne mai il comportamento reale è il modo più rapido per accorgersi, mesi dopo, che non si è mai attivata correttamente.
• Documentazione sovradimensionata fin dall’inizio. Meglio partire con istruzioni minime, verificare che risolvano il problema reale, ed espandere solo dove serve piuttosto che scrivere un manuale di cinquanta pagine per un compito che, alla prova dei fatti, richiedeva sei righe.
• Dimenticare la manutenzione. Se il tono di voce del brand cambia, o cambiano le policy di reso, la Skill va aggiornata di conseguenza: è un documento vivo, non un artefatto scritto una volta per sempre.
• Non coinvolgere chi userà davvero la Skill. Se scrivi da solo le regole del customer care senza chiedere conferma a chi risponde ai clienti tutti i giorni, rischi di formalizzare convenzioni che nella pratica sono già superate. Le Skill funzionano meglio quando raccolgono conoscenza vera, non quella che si presume esista sulla carta.
• Confondere una Skill con un prompt travestito. Se ti ritrovi a scrivere istruzioni valide per un solo caso specifico (“scrivi la scheda per QUESTO prodotto in QUESTO modo”), probabilmente non ti serve una Skill ma un prompt normale. Una Skill ha senso quando la regola si applica a una classe intera di richieste future, non a una singola occorrenza.

Manutenzione nel tempo: una Skill non è “finita”

Un’ultima cosa da tenere a mente, forse la più facile da dimenticare nell’entusiasmo iniziale: una Skill ben scritta oggi può smettere di essere accurata tra sei mesi. I fornitori di spedizione cambiano tempistiche, il tono di voce del brand si evolve, le categorie di prodotto si moltiplicano. Vale la pena trattare le Skill più importanti quelle che tutto il team usa ogni giorno come tratteresti un documento operativo qualsiasi: con un responsabile designato, una revisione periodica (anche solo trimestrale) e un canale attraverso cui chi la usa può segnalare quando qualcosa non torna più. Le Skill che invecchiano meglio sono quelle scritte con l’aspettativa esplicita di essere riviste, non quelle pensate come un’operazione da fare una volta e dimenticare.

Domande frequenti

Serve saper programmare per creare una Skill? No. Una Skill semplice è solo testo Markdown con un blocco di metadati all’inizio. Servono script e codice solo per competenze più avanzate, ad esempio quelle che devono generare file Excel con formule o elaborare dati con librerie specifiche.

Quante Skill posso avere attive contemporaneamente? Non esiste un limite tecnico rigido, ma conviene ragionare in termini di qualità più che di quantità: meglio un piccolo numero di Skill precise e ben mantenute che una collezione ampia di competenze scritte in fretta e mai più riviste. Se ti accorgi di non ricordare più cosa fa ciascuna delle tue Skill, è il segnale che è ora di consolidarne o eliminarne qualcuna.

Posso far riferimento a un’altra Skill dall’interno di una Skill? No, le Skill non possono richiamarsi esplicitamente a vicenda. Claude, però, può decidere di usarne più di una nella stessa richiesta in modo automatico, se entrambe risultano pertinenti al compito. Per questo conviene tenerle piccole e mirate: si compongono meglio tra loro rispetto a un’unica competenza che prova a coprire tutto.

Cosa succede se la Skill non si attiva quando dovrebbe? Nella grande maggioranza dei casi il problema è nella descrizione del frontmatter: se non è abbastanza specifica su “quando” usare la Skill (e non solo su “cosa” fa), Claude non avrà elementi sufficienti per riconoscere che la tua richiesta è pertinente. Riscrivila in modo più puntuale ed esplicito, e ritesta.

Le Skill che scrivo funzionano anche se cambio piano o account? Il formato SKILL.md segue una specifica pubblica (Agent Skills), quindi in linea di principio una Skill scritta bene è portabile. Va comunque ricaricata e riabilitata sul nuovo account o piano, e vale la pena rifare un giro di test dopo ogni migrazione.

Una Skill può contraddire un’altra Skill attiva contemporaneamente? Sì, ed è un rischio reale quando il numero di competenze cresce senza controllo: se la Skill per il tono di voce dice di essere sempre informali e quella per le comunicazioni legali richiede un registro più formale, Claude deve arbitrare tra le due indicazioni senza una gerarchia esplicita. La soluzione più semplice è essere specifici nelle rispettive descrizioni su quale ambito ciascuna Skill copre, così da ridurre le sovrapposizioni, e testare periodicamente i casi limite in cui più competenze potrebbero attivarsi insieme.

Devo scrivere la Skill in italiano o in inglese? Puoi scriverla nella lingua che preferisci: Claude legge e applica le istruzioni indipendentemente dalla lingua in cui sono scritte. Per un’azienda italiana ha senso scrivere la Skill in italiano, soprattutto se altre persone del team dovranno leggerla o modificarla in futuro.

Conclusione: da dove iniziare

Se gestisci un ecommerce e usi già Claude per scrivere contenuti, rispondere ai clienti o preparare report, il modo più rapido per capire se le Skill fanno per te è individuare il compito che ripeti più spesso e per cui ti ritrovi a scrivere le stesse istruzioni ogni volta. Parti da lì: scrivi una Skill minima, testala su richieste reali, e allargala solo quando emergono lacune concrete.

Non serve alcuna competenza di programmazione per cominciare: bastano istruzioni chiare in Markdown e un po’ di pazienza nell’iterare sulla descrizione, finché Claude non la richiama esattamente quando dovrebbe. Una volta che la prima Skill funziona in modo affidabile, il passo successivo viene quasi da sé: individuare il secondo compito ripetitivo, poi il terzo, fino a costruire un piccolo repertorio di competenze che riflette davvero come lavora il tuo negozio online non un manuale teorico scritto a tavolino, ma la codificazione di pratiche che già usi ogni giorno.

Il resto coerenza del brand, tempo risparmiato, meno spiegazioni ripetute agli assistenti AI e ai nuovi collaboratori arriva quasi da solo, un flusso di lavoro alla volta.