# Skill degli agenti AI: cosa sono e come scriverne una che funziona

> Le skill degli agenti AI trasformano le istruzioni che ripeti in file che il tuo agente carica quando servono. Scopri come funziona SKILL.md, guarda esempi reali e impara a scriverne una.

Last updated: 2026-09-28T10:00:00

Canonical URL: https://crevio.co/it/blog/ai-agent-skills

*Ultimo aggiornamento: settembre 2026*

**Se hai spiegato la tua politica sui rimborsi a un agente AI più di due volte, hai già scritto una skill per agenti. Continui solo a cancellarla.** Le skill degli agenti AI sono la soluzione: un file breve che contiene una procedura e che l’agente legge solo quando il compito lo richiede. Scrivi le regole una volta e ogni conversazione futura partirà da lì.

Questa guida è pensata per titolari e responsabili d’azienda che usano un agente AI per lavorare davvero e sono stanchi di dover ripetere ogni volta le stesse cose. Spiega che cos’è davvero una skill, come gli agenti decidono quando caricarla, quali attività ne meritano una e include un esempio completo da copiare.

- **Una skill è una cartella con un file SKILL.md**: contiene un nome, una breve descrizione e le istruzioni. Script e file di riferimento sono facoltativi
- **Gli agenti leggono subito solo la descrizione** (circa 100 token per skill). Il resto viene caricato quando trova una corrispondenza con il compito, quindi anche una libreria ampia ha un costo ridotto
- **È uno standard aperto.** La stessa skill funziona in Claude, ChatGPT e Codex, Gemini CLI, Cursor, GitHub Copilot e decine di altri agenti
- **La descrizione è la parte più importante.** Se è vaga, la skill non si attiva oppure si attiva per il lavoro sbagliato
- **Le skill di terze parti sono codice che stai installando.** Un audit di febbraio 2026 ha rilevato problemi di sicurezza critici nel 13,4% delle skill pubbliche

## Che cosa sono le skill degli agenti AI?

**Le skill degli agenti AI sono pacchetti riutilizzabili di istruzioni che insegnano a un agente come svolgere una specifica attività secondo il tuo metodo.** Ogni skill è una cartella che contiene un file `SKILL.md`. Il file inizia con un’intestazione breve (un `name` e un `description`), seguita da istruzioni in linguaggio semplice: passaggi, regole, formato dell’output e casi limite.

L’idea nasce da Anthropic, che [ha presentato Agent Skills nell’ottobre 2025](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills), descrivendole come «cartelle organizzate di istruzioni, script e risorse che gli agenti possono individuare e caricare dinamicamente». A dicembre 2025 ha pubblicato il formato come standard aperto su [agentskills.io](https://agentskills.io/home) e da allora la maggior parte dei principali agenti lo ha adottato.

![Post di ingegneria di Anthropic che presenta Agent Skills, pubblicato il 16 ottobre 2025](https://crevio.co/vite/assets/anthropic-agent-skills-announcement-fr3rjecj.png)

Il termine viene usato anche in senso più ampio per indicare «le cose che gli agenti AI sanno fare» oppure le competenze umane necessarie per gestire gli agenti. Sono temi reali, ma quando nel 2026 chi costruisce o acquista agenti parla di «skill», quasi sempre intende questo: una procedura impacchettata che l’agente può prendere e mettere da parte.

### Che cosa contiene una cartella skill

La [specifica Agent Skills](https://agentskills.io/specification) mantiene deliberatamente la struttura essenziale:

| Parte | Obbligatoria? | Che cosa contiene |
|---|---|---|
| `SKILL.md` | Sì | Intestazione con `name` e `description`, seguita dalle istruzioni |
| `scripts/` | No | Codice che l’agente può eseguire, ad esempio un generatore di report o un validator |
| `references/` | No | Documenti più lunghi: la tua politica completa, un listino prezzi, una guida di stile |
| `assets/` | No | Modelli, file di esempio, tabelle di consultazione |

L’intestazione ha limiti precisi. Il campo `name` può contenere al massimo 64 caratteri tra lettere minuscole, numeri e trattini. Il campo `description` può contenere al massimo 1.024 caratteri e, secondo la specifica, «dovrebbe descrivere sia che cosa fa la skill sia quando usarla».

![Pagina della specifica Agent Skills che mostra il file SKILL.md obbligatorio e le cartelle facoltative scripts, references e assets](https://crevio.co/vite/assets/agentskills-specification-idwfflfk.png)

## Come caricano le skill gli agenti

L’aspetto più interessante del formato è che un agente non legge tutte le skill contemporaneamente. Le carica su tre livelli, secondo quello che la specifica chiama **progressive disclosure**.

![Diagramma dei tre livelli caricati da un agente: nome e descrizione sempre, istruzioni di SKILL.md quando un’attività corrisponde e riferimenti o script solo quando un passaggio ne ha bisogno](https://crevio.co/vite/assets/how-agents-load-skills-g1wbt1jh.svg)

1. **Individuazione.** All’inizio di ogni sessione, l’agente legge solo il nome e la descrizione di ogni skill installata, circa 100 token per ciascuna
2. **Attivazione.** Quando la richiesta corrisponde a una descrizione, l’agente legge tutto il file `SKILL.md` di quella skill. La specifica consiglia di restare sotto i 5.000 token e le 500 righe
3. **Esecuzione.** L’agente segue le istruzioni e apre un file di riferimento o esegue uno script solo quando un passaggio lo indica

Ecco perché un’azienda può tenere installate decine di skill senza rallentare l’agente né pagare per un contesto che non utilizzerà mai. Ed è anche il motivo per cui la descrizione pesa così tanto: è l’unica parte che l’agente vede prima di decidere. La [guida alla scrittura](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) di Anthropic afferma che l’agente potrebbe scegliere tra «oltre 100 skill disponibili» usando proprio quel campo.

## Skill, prompt, strumenti e memoria a confronto

Le skill si sovrappongono a diversi strumenti che forse usi già. La differenza sta in ciò che contiene ciascuno e nel momento in cui viene mostrato.

| | Che cosa contiene | Quando lo vede l’agente | Ideale per |
|---|---|---|---|
| **Prompt** | Una richiesta | Solo in questa conversazione | Attività una tantum |
| **Istruzioni personalizzate** | Preferenze permanenti | Sempre, in ogni conversazione | Tono, nome, fuso orario |
| **Memoria** | Informazioni apprese dall’agente | Quando le recupera | «Il nostro mese più intenso è novembre» |
| **Strumento o integrazione** | Accesso a un sistema | Quando deve agire | Leggere ordini, inviare email |
| **Skill** | Una procedura | Solo quando l’attività corrisponde | «Come gestiamo i rimborsi» |

La confusione più frequente è quella tra skill e strumenti. **Uno strumento dà all’agente una chiave; una skill gli dice che cosa fare una volta entrato.** Una skill che dice «controlla l’ordine nel nostro negozio» è inutile se l’agente non ha accesso al negozio; allo stesso tempo, avere accesso al negozio è rischioso senza una skill che stabilisca che cosa l’agente può e non può fare. Di solito servono entrambi.

Le skill e la memoria sono anche ciò che distingue un agente che ogni volta parte da zero da uno che migliora con l’uso: è la distinzione che abbiamo tracciato in [Dipendente AI vs agente AI](/it/blog/ai-employee-vs-ai-agent).

## Dove funzionano oggi le skill degli agenti AI

Poiché il formato è uno standard aperto, una skill che scrivi non è vincolata a un solo prodotto. L’elenco dei client di [agentskills.io](https://agentskills.io/home) include Claude e [Claude Code](/it/blog/claude-code), ChatGPT e Codex, Gemini CLI, Cursor, GitHub Copilot, VS Code, OpenCode, Goose, Databricks, Snowflake e oltre 30 altri prodotti.

Sono nati anche gli elenchi pubblici. [skills.sh](https://skills.sh/) raccoglie skill della community che puoi installare con un solo comando, da skill per la scrittura e la ricerca a quelle create per strumenti specifici.

![skills.sh, un elenco pubblico di skill per agenti della community con classifica delle installazioni](https://crevio.co/vite/assets/skills-sh-directory-f00n0in6.png)

Gran parte di questa libreria è scritta da sviluppatori per agenti di coding. Le skill davvero utili per gestire un’azienda raramente compaiono in una classifica, perché contengono informazioni che solo tu conosci: le tue politiche, la tua voce, i tuoi numeri.

## Esempi di skill per agenti AI per una piccola impresa

Ecco come potrebbe essere una libreria di skill di partenza per un’azienda che vende prodotti o servizi digitali:

| Skill | Che cosa codifica | Si attiva quando |
|---|---|---|
| `handling-refund-requests` | Politica sui rimborsi, regole di approvazione, tono delle risposte | Un cliente chiede un rimborso |
| `writing-weekly-report` | Quali numeri considerare, in quale ordine e che cosa è «rilevante» | Chiedi com’è andata la settimana |
| `writing-in-brand-voice` | Parole che usi, parole che non usi mai, email di esempio | Deve essere preparato qualsiasi testo rivolto ai clienti |
| `launching-a-product` | Checklist per il lancio, sequenza di email, regole sui prezzi | Dici «lanciamo X» |
| `qualifying-leads` | Chi è un cliente adatto, che cosa chiedere, quando fissare una chiamata | Arriva un nuovo lead |
| `pricing-a-custom-quote` | Listino, minimi, sconti consentiti | Un potenziale cliente chiede «quanto costa?» |

Nota che cosa manca: «scrivi un post per il blog» o «riassumi questo PDF». Il modello sa già svolgere bene queste attività. Una skill si guadagna il suo posto quando contiene un contesto che l’agente non può indovinare.

## Che cosa merita una skill (e che cosa no)

Prima di scrivere qualsiasi cosa, valuta l’attività con due domande: quanto spesso si ripete e l’agente commette errori se non ha il tuo contesto?

![Matrice a quattro quadranti: scrivi una skill solo per le attività che si ripetono spesso e che l’agente sbaglia senza il tuo contesto](https://crevio.co/vite/assets/what-deserves-a-skill-bje0433g.svg)

PostHog, i cui team hanno pubblicato 226 skill in uno store interno, arriva alla stessa conclusione nel [suo articolo sulla scrittura delle skill](https://posthog.com/newsletter/writing-agent-skills): crea skill per il lavoro che si ripete, che gli agenti fanno fatica a svolgere correttamente per impostazione predefinita o che richiede un contesto non ovvio. Tutto il resto è zavorra e rende più difficile la scelta dell’agente.

## Come scrivere una skill per un agente AI

Non serve saper programmare. Una skill utile è una procedura scritta bene, con un’intestazione chiara.

### Passaggio 1: svolgi prima l’attività con l’agente

Il consiglio di Anthropic è iniziare da una conversazione reale, non da un file vuoto. Svolgi l’attività una volta, correggi l’agente mentre procedi e nota che cosa hai dovuto spiegargli. Quelle correzioni sono la skill.

### Passaggio 2: scrivi prima di tutto la descrizione

La descrizione decide se la skill verrà mai caricata. Scrivila in terza persona, spiega che cosa fa la skill ed elenca le frasi che una richiesta potrebbe contenere davvero:

- **Debole:** «Aiuta con i clienti.»
- **Forte:** «Gestisce le richieste di rimborso per i prodotti digitali. Usala quando un cliente chiede un rimborso, dice che un acquisto non ha funzionato o menziona un chargeback.»

### Passaggio 3: scrivi il corpo come obiettivi e regole, non come uno script

Indica l’obiettivo, le regole vincolanti, i passaggi, il formato dell’output e i casi limite. Sii preciso sui vincoli e flessibile sulla formulazione. Vale la pena citare l’avvertimento di PostHog: «Specificare troppo trasforma una skill in un workflow e priva l’intelligenza per cui stai pagando».

### Passaggio 4: sposta il materiale lungo nei riferimenti

Se la tua politica completa occupa tre pagine, inseriscila in `references/refund-policy.md` e indica all’agente esattamente quando aprirla. Mantieni i riferimenti a un solo livello di profondità: i file che rimandano ad altri file tendono a essere letti solo a metà.

### Passaggio 5: testala con tre richieste reali

Prova tre richieste realistiche, inclusa una che *non* dovrebbe attivare la skill. Se si attiva per l’attività sbagliata o non intercetta una richiesta ovvia, quasi sempre il problema è la descrizione.

### Un esempio completo da copiare

```
---
name: handling-refund-requests
description: Handles refund requests for digital products (courses, templates, downloads). Use when a customer asks for a refund, says a purchase did not work, disputes a charge, or mentions a chargeback.
---

# Handling refund requests

## Goal
Resolve the request in one reply and keep the customer where possible.
Never refund outside policy without the owner's approval.

## Policy
- Courses: full refund within 14 days if under 30% of lessons completed
- Templates and downloads: no refund after download; offer a fix or an exchange
- Duplicate purchases: always refund the duplicate

## Steps
1. Look up the order: product type, purchase date, usage
2. Compare against the policy above
3. Within policy: draft the refund and the reply, then ask for approval
4. Outside policy: draft a reply offering the fix or exchange. Do not promise a refund
5. Chargeback, lawyer, or angry repeat contact: stop and hand it to the owner

## Reply style
Short and warm. Use their first name. Apologize once, not three times.
Sign off as "The Studio Team".

## Edge cases
- Bought the wrong course: offer a free swap before a refund
- Payment failed but they were charged: treat as a duplicate
```

Sono meno di 250 parole e sostituiscono una conversazione che altrimenti dovresti ripetere ogni settimana.

## Quello che nessuno ti dice sulle skill degli agenti

Il formato è semplice. Le sorprese arrivano dopo aver convissuto per qualche mese con una libreria di skill.

**Le skill entrano in conflitto quando la libreria cresce.** L’articolo di PostHog cita una scoperta di Databricks: «con l’aggiunta di nuove skill, gli agenti scelgono sempre più spesso quella sbagliata». Due skill con descrizioni sovrapposte («email ai clienti» e «risposte dell’assistenza») si alterneranno in modo imprevedibile. Uniscile oppure fai in modo che ogni descrizione indichi le situazioni che l’altra non copre.

**Le skill diventano obsolete senza farsi notare.** Cambia il periodo per i rimborsi, cambiano i prezzi, uno strumento viene rinominato e la skill continua ad applicare con sicurezza le vecchie regole. Metti tutto ciò che è soggetto a variazioni in un unico file di riferimento che aggiorni davvero, come faresti in una [knowledge base per agenti AI](/it/blog/ai-agent-knowledge-base), e controlla le skill ogni volta che cambia la politica sottostante.

**Le skill di terze parti sono software, non testo.** A febbraio 2026 Snyk ha analizzato 3.984 skill pubbliche e [ha rilevato falle di sicurezza nel 36,82% e problemi critici nel 13,4%](https://snyk.io/blog/toxicskills-malicious-ai-agent-skills-clawhub/), inclusi 76 payload dannosi confermati, progettati per rubare credenziali, installare backdoor o esfiltrare dati. Le indicazioni di Anthropic sono chiare: installa skill solo da fonti di cui ti fidi e leggi prima qualsiasi altra skill. Abbiamo trattato lo stesso rischio nella nostra analisi delle [alternative a OpenClaw](/it/blog/openclaw-alternatives), dove le skill della community erano una delle principali preoccupazioni.

**Una skill non concede autorizzazioni.** Le istruzioni che dicono «emetti il rimborso» non servono a nulla senza accesso al sistema di pagamento, e l’accesso senza limiti è il pericolo maggiore. Per i pagamenti, gli invii e le eliminazioni, mantieni sempre un passaggio di approvazione, qualunque cosa dica la skill. È la stessa regola che diamo per [affidare il lavoro agli agenti AI in una piccola impresa](/it/blog/ai-agents-for-small-business): tutto ciò che esce dall’azienda deve essere preparato, non inviato.

## Come usa le skill Crevio

[Crevio](https://crevio.co/) è un AI business builder: descrivi ciò che vuoi vendere e il suo agente crea il negozio, gestisce i pagamenti, scrive il marketing e continua a lavorare con te sull’attività. Le skill permettono all’agente di portare con sé il know-how da una conversazione all’altra.

![Homepage di Crevio: l’AI che crea il tuo negozio, gestisce i pagamenti, scrive il marketing e fa crescere le vendite](https://crevio.co/vite/assets/crevio-homepage-nvib9pqi.png)

Ecco come funziona in pratica:

- **Include skill integrate.** L’agente viene fornito con skill per cold email, lead magnet, prezzi, [audit SEO](/it/blog/ai-agents-for-seo), creatività per gli annunci, post per i social e gestione di PDF, fogli di calcolo, documenti e presentazioni
- **Puoi installare e caricare le tue skill.** La pagina Skills nelle impostazioni include un marketplace di skill della community e ti permette di caricare le tue come `.zip`, come cartella o come singolo file `SKILL.md`. Le skill caricate restano private nel tuo account
- **Scrive skill a partire dall’esperienza.** Dopo un’attività lunga e articolata, Crevio analizza ciò che è successo e salva la parte riutilizzabile come skill. Le trovi nella sezione «Imparate dalla tua AI», dove puoi leggerle o rimuoverle
- **Puoi insegnare mostrando come si fa.** «Insegna un’attività» registra ciò che fai sul computer dell’agente e Crevio trasforma la registrazione in una skill riutilizzabile

La nota doverosa: una skill che l’agente ha scritto per sé è valida solo quanto la conversazione da cui ha imparato. Leggi ciò che ha salvato, soprattutto se riguarda pagamenti o clienti. Crevio ha un piano gratuito, quindi puoi provare la libreria di skill senza inserire una carta.

## Domande frequenti

### Le skill degli agenti sono la stessa cosa di MCP?

No. MCP (Model Context Protocol) è uno dei diversi modi per [collegare un agente alle app della tua azienda](/it/blog/connect-ai-agents-to-business-apps), come il CRM o la posta in arrivo. Una skill è una procedura scritta che dice all’agente come usare ciò a cui ha accesso. Funzionano insieme: MCP fornisce l’accesso, mentre la skill fornisce il criterio per stabilire quando e come usarlo.

### Devo saper programmare per scrivere una skill per un agente AI?

No. La maggior parte delle skill aziendali utili è scritta in Markdown semplice: un’intestazione, un obiettivo, regole e passaggi. Gli script sono facoltativi e vale la pena aggiungerli solo per i passaggi che devono essere eseguiti sempre nello stesso modo, come generare un report formattato o verificare un calcolo.

### Le skill di Claude sono la stessa cosa delle skill per agenti?

Sì, nella pratica. Anthropic ha creato il formato per Claude e poi lo ha pubblicato come standard aperto Agent Skills. Una skill scritta per Claude generalmente funziona con qualsiasi agente che supporta lo standard, purché non dipenda da uno strumento disponibile solo in un determinato prodotto.

### Quante skill dovrebbe avere un agente?

Tante quante sono le tue procedure distinte e ripetute, non di più. Il costo di caricamento è ridotto, ma descrizioni sovrapposte fanno scegliere all’agente quella sbagliata. Se due skill potrebbero plausibilmente rispondere alla stessa richiesta, uniscile.

## In breve

Le skill degli agenti AI fanno la differenza tra un agente che devi gestire e un agente che hai addestrato. Inizia dalla procedura che continui a dover spiegare, scrivi la descrizione come se tutto dipendesse da quella e lascia breve il resto. La libreria di skill migliore non è la più grande, ma quella in cui ogni file contiene qualcosa che ti eri stancato di ripetere.

## Articoli correlati

- [Dipendente AI vs agente AI: la differenza che conta davvero](/it/blog/ai-employee-vs-ai-agent)
- [Agenti AI per le piccole imprese: da quali attività iniziare](/it/blog/ai-agents-for-small-business)
- [I migliori agenti AI per Slack nel 2026 (11 strumenti a confronto)](/it/blog/best-ai-agents-for-slack)