Claude Skills: come funzionano, come installarle e quali usare in una PMI

Le Claude Skills non sono semplici prompt da copiare. Sono istruzioni strutturate che Claude carica solo quando servono, con un sistema di discovery a basso costo (circa 100 token per skill) e caricamento completo del contenuto solo al momento dell’uso.

Questo articolo è la versione tecnica aggiornata e più completa di quello precedente. Spiega l’architettura reale, la differenza tra i due tipi di skill, il protocollo di test che uso nelle aziende, come installarle correttamente, quali sono davvero utili a una PMI italiana e come evitare gli errori più comuni.

Come funzionano davvero le Claude Skills (l’architettura)

Il meccanismo si chiama progressive disclosure ed e il motivo per cui si possono avere decine di skill senza pagare un costo di contesto enorme.

Quando inizia una sessione, Claude legge solo il nome e la descrizione di ogni skill installata (circa 100 token per skill). Questo costo e fisso, indipendentemente da quanto sia lunga la skill.

Quando il prompt dell’utente corrisponde alla descrizione di una skill, Claude carica il corpo completo del file SKILL.md (tipicamente sotto le 5000 token). Solo a questo punto legge le istruzioni dettagliate, gli esempi, le regole e i riferimenti.

Se la skill contiene script o file di supporto nella cartella scripts/ o references/, questi vengono caricati solo se la skill li richiede esplicitamente durante l’esecuzione.

Regola delle 500 righe: se il corpo della skill supera le 500 righe, si spacchetta in file separati di reference. Questo mantiene la discovery veloce e il caricamento selettivo. Superare questa soglia senza spacchettare rende la skill piu lenta da attivare.

Questo approccio e molto diverso da un normale prompt o da un file CLAUDE.md molto lungo: la skill resta leggera finche non serve davvero. Nelle implementazioni che seguo su TheDrobot, questa architettura permette di avere 30-40 skill attive senza rallentare le risposte su compiti non correlati.

Due tipi di skill (Capability Uplift vs Encoded Preference)

Questa distinzione e fondamentale e manca nella maggior parte delle guide italiane.

Capability Uplift Skills
Danno a Claude un’abilita che non ha nativamente.
Esempi: leggere PDF complessi con tabelle, creare file .docx o .pptx veri con formattazione, fare scraping web, eseguire test browser con Playwright.
Queste skill contengono quasi sempre script eseguibili nella cartella scripts/.

Encoded Preference Skills
Codificano il vostro modo di lavorare su un compito che Claude gia sa fare.
Esempi: stile di copywriting, formato di report settimanale, checklist di code review, tono di voce per le email ai clienti.
Queste skill sono fatte soprattutto di istruzioni, esempi e regole (fai sempre cosi, non fare mai cosi).

Nelle 12 aziende italiane dove le abbiamo implementate (tra cui RistorantePRO, agenzie di marketing e studi professionali), la maggior parte del valore viene dalle Encoded Preference Skills (brand voice, formato offerte, reportistica) e da 2-3 Capability Uplift forti (pdf, xlsx, docx).

Claude.ai Skills vs Claude Code Skills

Sono due sistemi diversi che condividono solo il formato file.

• Claude.ai Skills: piu semplici, si caricano dalle impostazioni (Capabilities → Skills). Ideali per chi non scrive codice. Possono essere condivise a livello di workspace su piani Team/Enterprise.
• Claude Code Skills: piu potenti. Si installano copiando la cartella dentro .claude/skills/ del progetto. Supportano subagent, hooks, tool restriction (allowed-tools) e integrazione piu profonda con il codebase.

Una skill scritta bene funziona su entrambi. La differenza e nell’ambiente di esecuzione e nella profondita di integrazione.

Come installare una skill (guida tecnica aggiornata)

Metodo 1 - Claude.ai (piu semplice)

1. Aprire Claude (app desktop o web).
2. Andare in Settings → Capabilities → Skills.
3. Cliccare Upload a skill e selezionare la cartella o il file SKILL.md.
4. (Opzionale) Attivare skill-creator se volete che Claude vi aiuti a costruire skill nuove.

Metodo 2 - Claude Code (piu potente)

1. Creare la cartella .claude/skills/nome-skill/ nel progetto.
2. Copiare dentro la cartella SKILL.md e gli eventuali file di supporto.
3. Riavviare la sessione Claude Code.

Metodo 3 - Usare il skill-creator (il piu veloce per chi parte da zero)

1. Aprire una nuova chat con un modello forte (Opus o Sonnet 5 con extended thinking).
2. Scrivere: “Use the skill-creator to build a skill for [descrizione precisa del compito]”.
3. Rispondere a tutte le domande di Claude in modo estremamente specifico.
4. Alla fine Claude genera la cartella completa.
5. Scaricare e installare con uno dei due metodi sopra.

Come testare una skill prima di usarla in produzione (protocollo che uso nelle aziende)

Questo passaggio e quello che la maggior parte delle persone salta, ed e il piu importante.

Protocollo di test (da fare sempre):

1. Test di attivazione positiva (5 varianti): scrivere 5 modi diversi di chiedere il compito. La skill deve attivarsi in tutti e 5 i casi.
2. Test di attivazione negativa (3 richieste non correlate): chiedere 3 cose che non c’entrano nulla. La skill deve restare silenziosa.
3. Test sul caso reale: usare la skill su un documento o un compito vero del vostro lavoro. Verificare almeno 5 righe a campione contro il risultato atteso.
4. Test di coerenza: chiedere lo stesso compito in 3 chat diverse. Il risultato deve essere coerente.

Se la skill fallisce uno di questi test, correggetela prima di adottarla.

Le 5 skill che una PMI italiana dovrebbe installare per prima

Nelle aziende dove entro, queste sono le skill che ripagano prima:

1. pdf (Anthropic) - Estrazione dati da fatture, moduli, contratti. Nel progetto RistorantePRO abbiamo caricato questa skill su 87 fatture reali del commercialista: il titolare ha verificato 5 a campione, ha visto che coincidevano al 100% e da quel giorno non ha piu passato due ore al mese a riclassificare dati. Vedi il caso completo.
2. xlsx (Anthropic) - Creazione e modifica di fogli Excel con formule. Vedi anche la guida n8n.
3. copywriting (Corey Haines) - Testi di vendita con metodo professionale. Vedi la skill abbinata.
4. brand-guidelines - Mantiene tutti i testi fedeli al vostro brand.
5. docx + pptx - Generazione di offerte e presentazioni vere.

Queste 5 coprono gia l’80% dei lavori ripetitivi che una PMI compra a ore.

Come vetare una skill prima di caricarla

Prima di caricare qualsiasi skill di terze parti:

• Leggete tutto il file SKILL.md
• Cercate richieste di dati sensibili, istruzioni ambigue o script che non capite
• Verificate la data dell’ultimo aggiornamento e quante persone la usano
• Se la skill contiene script eseguibili, controllate cosa fanno

Una skill e un manuale operativo: se non lo capireste se ve lo desse un consulente esterno, non lo caricate.

Un controllo in piu, che quasi tutti saltano: guardate quando la skill e stata aggiornata l’ultima volta e su quale repository vive. Una skill ferma da mesi puo funzionare ancora oggi, ma nessuno la correggera’ se il modello sottostante cambia comportamento su un caso limite che prima gestiva bene.

---

Valerii Yerokhin - CEO di TheDrobot

Nelle aziende dove entro, la resistenza iniziale non e mai tecnica: e la convinzione che serva un informatico. Poi il titolare carica la skill delle fatture, la prova su un PDF vero del suo commercialista e la discussione finisce lì. Il passo difficile e il primo file, non il decimo. Le skill restano un livello leggero; i sistemi interni e i portali sono un altro mestiere, quello dello sviluppo di web app e portali interni.

La skill abbinata
Questo articolo e accompagnato dalla skill pdf dell’archivio ufficiale di Anthropic. Potete scaricarla direttamente dal repository e caricarla seguendo la guida sopra.

---

(Questo articolo e stato riscritto il 16 agosto 2026 integrando l’architettura di discovery, il protocollo di test e le distinzioni tecniche emerse dalle guide di Duet.so, BuildFastWithAI e dal workflow di Ruben Hassid, filtrate attraverso 12 implementazioni reali in PMI italiane.)