Skill di Claude: cosa sono, come si creano e quali usare

Se usi Claude per lavoro, rispieghi spesso le stesse cose, come il tono del brand o il formato dei report. Le skill servono a scriverle una volta sola. Poi Claude le applica da solo quando la richiesta c’entra.

Anthropic le definisce «cartelle di istruzioni, script e risorse» che Claude carica quando servono. Dentro ci può stare una semplice checklist oppure uno script che controlla un file Excel. Sono file di testo, quindi per scriverne una non serve saper programmare.

Le ha presentate Anthropic il 16 ottobre 2025, con il nome Agent Skills. Il 18 dicembre 2025 ha pubblicato il formato come standard aperto, che oggi supportano decine di strumenti (l’elenco è nella vetrina ufficiale).

Tra questi ci sono ChatGPT e Codex di OpenAI, GitHub Copilot, Cursor e Gemini CLI. Una skill scritta bene, quindi, la porti anche fuori da Claude.

Dentro Claude le skill funzionano in tre posti:

• App di Claude, dal sito o da desktop. Secondo il Centro assistenza ci sono su tutti i piani, gratuito compreso, se è attiva l’opzione «Esecuzione del codice e creazione di file» in Impostazioni > Capacità. Le gestisci da Personalizza > Competenze, il nome che hanno nell’app in italiano. Nei piani Team ed Enterprise si possono condividere con i colleghi o attivare per tutta l’organizzazione.
• Claude Code, dove le skill sono cartelle sul tuo computer. Se accedi con l’account Claude, ritrovi anche quelle attive nell’app (la sincronizzazione va solo in quella direzione).
• API, insieme allo strumento di esecuzione del codice. Qui le skill caricate sono condivise con tutto il workspace.

Una skill è una cartella con dentro almeno il file SKILL.md. In cima c’è un’intestazione in YAML con due campi obbligatori, name e description, cioè il nome e una frase su cosa fa e quando usarla.

Sotto ci sono le istruzioni in Markdown, scritte come le scriveresti a una persona. Accanto puoi mettere altri file, come prevede la specifica ufficiale.

nome-skill/
  SKILL.md       intestazione e istruzioni (obbligatorio)
  references/    documenti da leggere solo se servono
  scripts/       codice che Claude esegue
  assets/        modelli, immagini, dati

Il punto forte è il caricamento progressivo (progressive disclosure). Funziona come un manuale con l’indice, che Claude legge per primo per poi aprire solo il capitolo che gli serve. La documentazione di Anthropic descrive tre livelli:

1. Nome e descrizione, sempre nel contesto, circa 100 token per skill.
2. Le istruzioni di SKILL.md, lette solo quando la richiesta corrisponde alla descrizione. Il consiglio è restare sotto i 5.000 token e le 500 righe.
3. Gli altri file, letti solo se servono. Gli script vengono eseguiti e nel contesto entra il risultato, mai il codice.

Per questo la descrizione è la parte più importante. Deve dire cosa fa la skill e quando usarla, con le parole che useresti tu in una richiesta.

Sì, rispetto all’alternativa. Senza skill incolleresti ogni volta le stesse istruzioni, o le metteresti nelle istruzioni di progetto che Claude legge a ogni conversazione. Con una skill paghi circa 100 token per la descrizione e il resto solo quando serve. E se un controllo lo fa uno script, Claude non deve riscrivere quel codice a ogni lavoro.

Gratis però non sono. Ogni descrizione occupa spazio a ogni messaggio, e una skill attivata resta nella conversazione. In Claude Code l’elenco delle skill ha un budget di circa l’1% del contesto, e se ne installi troppe le descrizioni meno usate vengono tagliate.

Alcune skill poi consumano tanto per scelta. Per esempio taste-skill dichiara 30-45 minuti e qualche centinaio di migliaia di token per costruire una pagina.

Poi ci sono le skill nate per risparmiare. La più nota è caveman, che fa rispondere Claude in stile telegrafico. JetBrains l’ha messa alla prova su più di 80 compiti reali con Claude Code. Anche tenendola sempre attiva, i token in uscita sono calati dell’8,5%, contro il 65% promesso, senza perdite di qualità misurabili.

Le abitudini che aiutano davvero sono queste:

• Tieni attive solo le skill che usi, e controlla quanto pesano con /skill-doctor e /context in Claude Code.
• Alle skill che richiami solo a mano aggiungi disable-model-invocation: true, così la loro descrizione esce dal contesto.
• Sposta i testi lunghi in file separati e i controlli ripetitivi in uno script.

Secondo la documentazione di Claude Code i posti principali sono questi:

• La cartella personale, ~/.claude/skills/nome-skill/SKILL.md, che vale in tutti i tuoi progetti.
• La cartella di progetto, .claude/skills/nome-skill/SKILL.md nel repository. La salvi con git e la condividi con il team, e la legge anche GitHub Copilot.
• I plugin, cioè i pacchetti che distribuiscono skill e altre estensioni. Le loro skill si richiamano con /nome-plugin:nome-skill.

Le modifiche a SKILL.md valgono subito, senza riavviare. Una skill la lanci scrivendo /nome-skill, oppure lasci che Claude la scelga da solo. I vecchi comandi in .claude/commands/ funzionano ancora, perché ormai sono skill anche loro.

In Claude Code la strada ufficiale passa dai plugin. Un repository GitHub può fare da marketplace, cioè da catalogo, che aggiungi una volta per poi installare quello che ti serve. Per le skill di Anthropic sui documenti, dentro Claude Code scrivi:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Dal terminale gli stessi comandi diventano claude plugin marketplace add e claude plugin install. Il marketplace ufficiale di Anthropic, claude-plugins-official, si configura da solo al primo avvio, quindi puoi installare subito la skill che aiuta a creare skill:

/plugin install skill-creator@claude-plugins-official

In alternativa c’è npx skills, uno strumento open source di Vercel che installa le skill in decine di agent diversi (serve Node.js 22.20 o successivo). Il suo catalogo è skills.sh. Con -g installi per tutti i progetti, con -a claude-code scegli Claude Code.

npx skills add hypnosdesign/claude-skill-scrittura-italiana -g -a claude-code

Puoi anche copiare a mano la cartella in ~/.claude/skills/. Nell’app di Claude, invece, carichi lo ZIP della skill da Personalizza > Competenze, con «+» e poi «Crea competenza».

Ecco un esempio utile a chi pubblica contenuti, una skill che controlla un articolo prima di metterlo online.

1. Crea la cartella. Il nome deve coincidere con il campo name, in minuscolo e con i trattini al posto degli spazi.

mkdir -p ~/.claude/skills/controllo-articolo

2. Scrivi SKILL.md. Salva questo testo in ~/.claude/skills/controllo-articolo/SKILL.md e adattalo alle tue regole.

---
name: controllo-articolo
description: Controlla un articolo del blog prima di pubblicarlo (titolo, meta description, link, tono, refusi). Da usare quando l'utente chiede di rivedere o preparare un articolo.
---

# Controllo articolo

## Procedura
1. Leggi tutto l'articolo prima di commentare.
2. Titolo: massimo 60 caratteri, parola chiave all'inizio.
3. Meta description: massimo 155 caratteri, diversa dalla prima frase.
4. Link: elenca i link e segnala quelli con un testo poco chiaro.
5. Tono: frasi brevi, seconda persona, termini tecnici spiegati.
6. Refusi: per ognuno riporta la frase corretta.

## Formato della risposta
- Elenco «Da correggere», in ordine di importanza.
- Elenco «Va bene così», al massimo tre righe.
- Non riscrivere l'articolo se l'utente non lo chiede.

3. Provala. Apri Claude Code (comando claude) e chiedi qualcosa che corrisponde alla descrizione, oppure scrivi /controllo-articolo. Se non parte, controlla con /skills che compaia nell’elenco. Se c’è ma Claude non la usa da solo, riscrivi la descrizione con le parole delle tue richieste.

4. Migliorala. Confronta il risultato con e senza skill, in una sessione nuova. Per le skill importanti c’è skill-creator, la skill ufficiale di Anthropic che ti intervista, scrive la bozza, prepara i casi di prova e sistema la descrizione. Puoi anche chiedere a Claude di trasformare in skill un lavoro appena fatto insieme, perché conosce già il formato.

5. Portala nell’app. Comprimi la cartella in uno ZIP, con la cartella alla radice dell’archivio, e caricala da Personalizza > Competenze.

cd ~/.claude/skills
zip -r controllo-articolo.zip controllo-articolo

Si confondono spesso, eppure servono a cose diverse.

Nella pratica si usano insieme. Il server MCP dà a Claude l’accesso a uno strumento, la skill gli insegna come usarlo secondo le tue regole, come spiega il Centro assistenza di Anthropic.

Per il file CLAUDE.md di Claude Code, la documentazione consiglia di restare sotto le 200 righe e di spostare in una skill le procedure in più passaggi. Sui collegamenti trovi tutto nella nostra guida a MCP.

Le skill rendono di più sui lavori che si ripetono e che oggi stanno nella testa di una persona sola. Nel commerciale, per esempio, una skill può preparare la bozza di un’offerta con la vostra struttura, partendo dagli appunti della call.

Il commerciale la rilegge e la manda. In amministrazione può leggere le fatture in PDF e compilare un Excel con fornitore, data, importo e scadenza, con uno script che verifica i totali e una persona che controlla il resto.

Nel marketing una skill tiene uguali il tono di voce e le regole del brand in post e newsletter, anche quando a scrivere sono persone diverse. Nello sviluppo raccoglie le convenzioni del codice e i controlli da fare prima del rilascio, e sta nel repository a disposizione di tutto il team.

Sono quelle che usiamo o che ti consigliamo di provare, con il link ufficiale. Prima di installarle leggi la parte sulla sicurezza.

Design e interfacce

• frontend-design (Anthropic). È la skill ufficiale per il design delle interfacce e spinge Claude verso scelte grafiche meno scontate. Si installa con /plugin install frontend-design@claude-plugins-official.
• Impeccable. Nasce da frontend-design e aggiunge comandi come /impeccable audit e /impeccable polish, con controlli automatici sugli errori tipici delle pagine generate. Si installa con npx impeccable install.
• taste-skill. Dà all’agente una direzione artistica e controlla la pagina in un browser vero prima di consegnarla. È la più ambiziosa del gruppo, e anche la più pesante in tempo e token.
• UI UX Pro Max. È un archivio consultabile di stili e abbinamenti di font, con regole per tipo di prodotto. È open source (licenza MIT) e serve Python 3. In Claude Code si installa con /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill e poi /plugin install ui-ux-pro-max@ui-ux-pro-max-skill.

Per ispirazione e componenti già pronti, guarda anche i tool che usiamo per non fare siti tutti uguali.

Documenti

Le skill di Anthropic docx, pptx, xlsx e pdf fanno creare e modificare a Claude file Word, PowerPoint, Excel e PDF veri. Nell’app sono già attive, in Claude Code le installi con il plugin document-skills.

Attenzione alla licenza. Il codice si può leggere ma è proprietario, quindi puoi usarle con i servizi di Anthropic e non puoi modificarle o ridistribuirle.

Testi

• humanizer. Toglie dai testi i segni tipici della scrittura generata, partendo dalla guida «Signs of AI writing» degli editor di Wikipedia. È pensata per l’inglese, e aggirare i rilevatori di AI non è tra i suoi obiettivi.
• scrittura-italiana. È una skill editoriale per l’italiano che corregge e riscrive senza cambiare il significato. Fa anche da humanizer contro i tic dell’italiano generato, come perifrasi e gerundi a raffica. Ha licenza CC BY-SA 4.0.

Marketing

Per il marketing parti dal plugin marketing di Anthropic, open source con licenza Apache 2.0. Ha otto skill per scrivere contenuti, pianificare campagne, controllare il tono del brand, analizzare i concorrenti, preparare sequenze di email, fare un audit SEO e leggere i risultati.

È pensato per Claude Cowork e funziona anche in Claude Code. Le skill sono in inglese, quindi conviene affiancarle a una skill con il tono di voce del tuo brand. In Claude Code si installa così:

/plugin marketplace add anthropics/knowledge-work-plugins
/plugin install marketing@knowledge-work-plugins

Una skill per i contenuti rende di più se le dai un metodo. Per i testi che devono convincere, parti da uno schema come il metodo AIDA.

In Minnovo lavoriamo ogni giorno con Claude Code e con l’app di Claude, collegati a diversi server MCP. Il più usato è il server MCP ufficiale di Lovable. Da lì leggiamo il codice dei progetti, mandiamo istruzioni all’agente di Lovable, controlliamo il diff e pubblichiamo. Le skill portano le nostre regole dentro questo lavoro:

• Per il design usiamo frontend-design, Impeccable e taste-skill, sui prototipi che costruiamo in locale prima di passare a Lovable (il metodo è raccontato in come creiamo siti web con l’AI).
• Per i documenti usiamo le skill ufficiali di Anthropic per Word, PowerPoint, Excel e PDF.
• Per i testi usiamo humanizer, l’originale in inglese, e una nostra skill interna sul tono di voce di Minnovo, adattata all’italiano partendo da humanizer e da scrittura-italiana. Anche questo articolo è passato da lì.
• Per i lavori che ripetiamo ci creiamo skill su misura, come lo stile di casa o i controlli prima di pubblicare.

Per tutto vale una regola. L’AI prepara, una persona controlla e decide, e niente parte o va online senza una conferma.

Se vuoi portare le skill nel lavoro del tuo team, collegate agli strumenti che usate già, è quello che facciamo con le nostre soluzioni AI. Si parte da un processo che oggi vi costa ore ogni settimana, e l’ultima parola resta a una persona.

Una skill può contenere script e far eseguire codice a Claude, ed è lì il rischio. Anthropic consiglia di usare solo skill di fonti affidabili, cioè create da te o da Anthropic. Una skill malevola, avverte la documentazione, può portare al furto di dati o ad accessi non autorizzati.

Il rischio è reale. A febbraio 2026 Snyk ha analizzato 3.984 skill pubbliche di ClawHub e skills.sh. Il 13,4% aveva almeno un problema di sicurezza critico e 76 contenevano codice malevolo, scritto per rubare credenziali o installare backdoor.

Prima di installare una skill:

• Leggi SKILL.md e tutti i file, script compresi.
• Diffida di quelle che scaricano programmi o testi da indirizzi esterni, perché ciò che scaricano può cambiare nel tempo.
• In Claude Code controlla il campo allowed-tools, che autorizza Claude a usare certi strumenti senza chiederti conferma.
• Non mettere mai password o chiavi API dentro una skill.
• Su skills.sh guarda anche i controlli di sicurezza di Gen, Socket e Snyk. Sono un aiuto in più, la lettura del codice resta a te.

Ci sono anche limiti tecnici da conoscere. Via API le skill girano senza accesso a internet e senza poter installare pacchetti, mentre nell’app l’accesso alla rete dipende dalle impostazioni dell’account.

• Descrizione vaga. «Aiuta con i documenti» non dice a Claude quando usarla. Scrivi cosa fa e quando, in terza persona.
• Una skill per tutto. Anthropic consiglia una skill per ogni flusso di lavoro, più facile da attivare e da correggere.
• SKILL.md troppo lungo. Oltre le 500 righe sposta i dettagli in file separati, collegati direttamente da SKILL.md.
• Spiegare a Claude ciò che sa già. Ogni riga occupa contesto, quindi scrivi solo ciò che è specifico del tuo lavoro.
• Doppioni. Se installi la stessa skill come plugin e con npx skills, Claude Code la carica due volte.
• Campi che l’app rifiuta. Claude Code accetta campi extra nell’intestazione, come disable-model-invocation. L’app e le API no, e bloccano il caricamento.