Agent Skills
Le Agent Skills sono capacità modulari che estendono le funzionalità di Claude. Ogni Skill racchiude istruzioni, metadati e risorse opzionali (script, template) che Claude usa automaticamente quando pertinenti.
L’utilizzo varia in base al prodotto
type e lo skill_id di ogni skill in container.skills e includi lo strumento di esecuzione del codice, nel cui container vengono eseguite le skill.skills dell’agente o caricale da un repository GitHub montato nella sessione.Perché usare le Skills
Le Skills sono risorse riutilizzabili, basate su filesystem, che forniscono a Claude competenze specifiche di dominio: flussi di lavoro, contesto e best practice che trasformano un agente generico in uno specialista. A differenza dei prompt (istruzioni a livello di conversazione per attività occasionali), le Skills vengono caricate su richiesta, così non devi ripetere le stesse indicazioni in ogni conversazione.
Vantaggi principali:
- Specializza Claude: Adatta le capacità ad attività specifiche di dominio
- Riduci le ripetizioni: Crea una volta, usa automaticamente
- Componi le capacità: Combina le Skills per attività complesse e articolate in più passaggi
Usare le Skills
Anthropic fornisce Agent Skills predefinite per le attività documentali più comuni (PowerPoint, Excel, Word, PDF), e puoi creare le tue Skills personalizzate. Entrambe funzionano allo stesso modo: una volta che una Skill è disponibile nel tuo ambiente, Claude la usa automaticamente quando è pertinente alla tua richiesta.
Le Agent Skills predefinite sono disponibili su claude.ai, sulla Claude API e su alcune piattaforme cloud. Per l’elenco delle Skills, consulta Skills disponibili.
Le Skills personalizzate ti permettono di racchiudere competenze di dominio e conoscenze organizzative. Creale in Claude Code, caricale tramite la Skills API o aggiungile nelle impostazioni di claude.ai.
Come funzionano le Skills
Le Skills usano l’ambiente VM di Claude per fornire capacità che vanno oltre ciò che è possibile con i soli prompt. Claude opera in una macchina virtuale con accesso al filesystem, il che consente alle Skills di esistere come directory contenenti istruzioni, codice eseguibile e materiali di riferimento, organizzate come una guida di onboarding che creeresti per un nuovo membro del team.
Questa architettura basata sul filesystem consente la “progressive disclosure” (divulgazione progressiva): Claude carica le informazioni per fasi secondo necessità, invece di consumare contesto in anticipo.
Le Skills possono contenere tre tipi di contenuto, ciascuno caricato in un momento diverso:
Livello 1: Metadati (sempre caricati)
Il frontmatter YAML della Skill fornisce le informazioni per l’individuazione:
---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---Claude carica questi metadati all’avvio e li include nel “system prompt” (prompt di sistema). La description è ciò con cui Claude confronta la tua richiesta per determinare se attivare la Skill, quindi deve indicare sia cosa fa la Skill sia quando usarla. Questo approccio leggero significa che puoi installare molte Skills senza penalità di contesto: finché una Skill non viene attivata, solo il suo nome e la sua descrizione occupano contesto.
Livello 2: Istruzioni (caricate all’attivazione)
Il corpo principale di SKILL.md contiene conoscenze procedurali: flussi di lavoro, best practice e indicazioni:
# PDF Processing
## Quick start
Use pdfplumber to extract text from PDFs:
```python
import pdfplumber
with pdfplumber.open("document.pdf") as pdf:
text = pdf.pages[0].extract_text()
```
For advanced form filling, see [FORMS.md](FORMS.md).Quando richiedi qualcosa che corrisponde alla descrizione di una Skill, Claude legge SKILL.md dal filesystem usando bash. Solo allora questo contenuto entra nella “context window” (finestra di contesto).
Livello 3: Risorse e codice (caricati secondo necessità)
Le Skills possono includere materiali aggiuntivi:
pdf-processing/SKILL.md(istruzioni principali)FORMS.md(guida alla compilazione dei moduli)REFERENCE.md(riferimento API dettagliato)scripts/fill_form.py(script di utilità)
Istruzioni: File Markdown aggiuntivi (FORMS.md, REFERENCE.md) contenenti indicazioni e flussi di lavoro specializzati
Codice: Script eseguibili (fill_form.py, validate.py) che Claude esegue usando bash, fornendo operazioni deterministiche senza caricare il loro codice nel contesto
Risorse: Materiali di riferimento come schemi di database, documentazione API, modelli o esempi
Claude accede a questi file solo quando vengono referenziati. Il modello basato sul filesystem fa sì che ogni tipo di contenuto abbia punti di forza diversi: istruzioni per indicazioni flessibili, codice per l’affidabilità, risorse per la consultazione di dati fattuali.
| Livello | Quando viene caricato | Costo in token | Contenuto |
|---|---|---|---|
| Livello 1: Metadati | Sempre (all’avvio) | ~100 token per Skill | name e description dal frontmatter YAML |
| Livello 2: Istruzioni | Quando la Skill viene attivata | Meno di 5k token | Corpo di SKILL.md con istruzioni e indicazioni |
| Livello 3+: Risorse | Secondo necessità | Nessuno finché non vi si accede | File inclusi. I file di riferimento vengono caricati nel contesto quando vengono letti. Gli script vengono eseguiti tramite bash e solo il loro output entra nel contesto. |
La divulgazione progressiva garantisce che solo il contenuto pertinente occupi la finestra di contesto in un dato momento.
L’architettura delle Skills
Le Skills vengono eseguite in un ambiente di esecuzione del codice in cui Claude ha accesso al filesystem, ai comandi bash e alle capacità di esecuzione del codice. Le Skills esistono come directory su una macchina virtuale e Claude interagisce con esse usando gli stessi comandi bash che useresti per navigare tra i file sul tuo computer.
Come Claude accede al contenuto delle Skill:
Quando una Skill viene attivata, Claude usa bash per leggere SKILL.md dal filesystem, portando le sue istruzioni nella finestra di contesto. Se queste istruzioni fanno riferimento ad altri file (come FORMS.md o uno schema di database), Claude legge anche quei file usando comandi bash aggiuntivi. Quando le istruzioni menzionano script eseguibili, Claude li esegue tramite bash e riceve solo l’output (il codice dello script stesso non entra mai nel contesto).
Cosa rende possibile questa architettura:
- Accesso ai file su richiesta: Claude legge solo i file di cui ogni attività ha bisogno. Una Skill può includere decine di file di riferimento, ma se la tua attività richiede solo lo schema delle vendite, quello è l’unico file che Claude carica. Gli altri rimangono nel filesystem e costano zero token.
- Esecuzione efficiente degli script: Quando Claude esegue
validate_form.py, il codice dello script non viene mai caricato nella finestra di contesto. Solo il suo output (come “Validation passed” o un messaggio di errore specifico) consuma token, il che rende gli script molto più efficienti rispetto a far generare a Claude codice equivalente durante l’attività. - Nessun limite pratico sul contenuto incluso: I file non consumano contesto finché non vi si accede, quindi le Skills possono includere documentazione API completa, grandi dataset o numerosi esempi. Non c’è alcuna penalità di contesto per il contenuto incluso che non viene utilizzato.
Esempio: caricamento di una Skill per l’elaborazione di PDF
Ecco come Claude carica e utilizza la Skill personalizzata pdf-processing degli esempi precedenti (non la Skill predefinita pdf):
- Avvio: Il prompt di sistema include:
pdf-processing - Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction. - Richiesta dell’utente: “Estrai il testo da questo PDF e riassumilo.”
- Claude chiama:
bash: cat pdf-processing/SKILL.md→ Istruzioni caricate nel contesto. - Claude determina: La compilazione di moduli non è necessaria, quindi Claude non legge
FORMS.md. - Claude completa l’attività: Usa le istruzioni di
SKILL.md.
Dove funzionano le Skills
Le Skills sono disponibili in tutti i prodotti per agenti di Claude. Per Claude Managed Agents, consulta la relativa pagina Skills.
I dettagli sulla Claude API in questa pagina si applicano anche alle piattaforme cloud che offrono le Skills. Per le eccezioni, consulta Ambito di condivisione e la voce della tua piattaforma in Disponibilità.
Claude API
La Claude API supporta sia le Agent Skills predefinite sia le Skills personalizzate. Entrambe funzionano in modo identico: elenca il type e lo skill_id di ogni Skill in container.skills.
Prerequisiti: L’uso delle Skills tramite l’API richiede lo strumento di esecuzione del codice, nel cui container vengono eseguite le Skills.
Usa le Agent Skills predefinite facendo riferimento al loro skill_id (pptx, xlsx, docx o pdf), oppure crea e carica le tue tramite la Skills API (endpoint /v1/skills). Per sapere come vengono condivise le Skills personalizzate, consulta Ambito di condivisione.
Le Skills sull’API vengono eseguite in un container isolato (sandbox) senza accesso alla rete e senza installazione di pacchetti in fase di esecuzione. Consulta Limitazioni e vincoli per i dettagli.
Per saperne di più, consulta Usare le Agent Skills con l’API.
Claude Code
Claude Code supporta le Skills personalizzate. Le Skills predefinite per i documenti (PowerPoint, Excel, Word, PDF) non sono disponibili in Claude Code, anche se la skill Claude API open source è inclusa. Consulta l’elenco completo dei comandi e delle Skills integrati forniti con Claude Code.
Skills personalizzate: Crea Skills come directory con file SKILL.md. Claude le scopre e le usa automaticamente.
Le Skills personalizzate in Claude Code sono basate sul filesystem e non richiedono caricamenti tramite API: posizionale in ~/.claude/skills/ (personali) o .claude/skills/ (di progetto).
Per saperne di più, consulta Usare le Skills in Claude Code.
claude.ai
claude.ai supporta sia le Agent Skills predefinite sia le Skills personalizzate.
Agent Skills predefinite: Queste Skills sono attive quando crei documenti. Claude le utilizza senza alcuna configurazione necessaria.
Skills personalizzate: Carica le tue Skills come file zip. Disponibile sui piani Pro, Max, Ultra, Team ed Enterprise con esecuzione del codice abilitata.
Per saperne di più sull’uso delle Skills in claude.ai, consulta le seguenti risorse nel Centro assistenza di Claude:
- Cosa sono le Skills?
- Usare le Skills in Claude
- Come creare Skills personalizzate
- Insegna a Claude il tuo modo di lavorare usando le Skills
Struttura di una Skill
Ogni Skill richiede un file SKILL.md con frontmatter YAML:
---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---
# Your Skill Name
## Instructions
[Clear, step-by-step guidance for Claude to follow]
## Examples
[Concrete examples of using this Skill]Campi obbligatori: name e description
Requisiti dei campi:
name:
- Massimo 64 caratteri
- Deve contenere solo lettere minuscole, numeri e trattini
- Non può contenere tag XML
- Non può contenere parole riservate:
anthropic,claude
description:
- Non deve essere vuoto
- Massimo 1.024 caratteri
- Non può contenere tag XML
La description deve includere sia cosa fa la Skill sia quando Claude dovrebbe usarla. Per indicazioni complete sulla creazione, consulta Best practice per la creazione di Skills.
Considerazioni sulla sicurezza
Usa Skills solo da fonti attendibili: quelle che hai creato tu stesso o ottenuto da Anthropic. Le Skills forniscono a Claude nuove capacità tramite istruzioni e codice, il che significa anche che una Skill dannosa può indurre Claude a chiamare strumenti o eseguire codice in modi che non corrispondono allo scopo dichiarato della Skill.
Considerazioni chiave sulla sicurezza:
- Esegui un audit approfondito: Esamina tutti i file inclusi nella Skill:
SKILL.md, script, immagini e altre risorse. Cerca schemi insoliti come chiamate di rete inattese, modelli di accesso ai file o operazioni che non corrispondono allo scopo dichiarato della Skill. - Le fonti esterne sono rischiose: Le Skills che recuperano dati da URL esterni comportano un rischio particolare, poiché il contenuto recuperato potrebbe contenere istruzioni dannose. Anche Skills affidabili possono essere compromesse se le loro dipendenze esterne cambiano nel tempo.
- Uso improprio degli strumenti: Le Skills dannose possono chiamare strumenti (operazioni sui file, comandi bash, esecuzione di codice) in modi dannosi.
- Esposizione dei dati: Le Skills con accesso a dati sensibili potrebbero essere progettate per far trapelare informazioni verso sistemi esterni.
- Trattale come l’installazione di software: Presta particolare attenzione quando integri Skills in sistemi di produzione con accesso a dati sensibili od operazioni critiche.
Per indicazioni su governance, verifica e deployment a livello di organizzazione, consulta Skills per l’enterprise. Le organizzazioni Claude Enterprise possono anche attivare la scansione del contenuto delle Skills per le Skills personalizzate caricate in claude.ai e Claude Cowork. La scansione non copre le Skills caricate tramite la Skills API o la Claude Console.
Skills disponibili
Agent Skills predefinite
Le seguenti Agent Skills predefinite sono disponibili per l’uso immediato:
- PowerPoint (pptx): Crea presentazioni, modifica slide, analizza il contenuto delle presentazioni
- Excel (xlsx): Crea fogli di calcolo, analizza dati, genera report con grafici
- Word (docx): Crea documenti, modifica contenuti, formatta testo
- PDF (pdf): Genera documenti e report PDF formattati
Per iniziare a usarle, consulta Inizia a usare gli Agent Skills nell’API.
Skills open-source
Anthropic pubblica anche Skills open-source nel repository skills:
- Skill Claude API: Fornisce a Claude materiale di riferimento API aggiornato, documentazione degli SDK e best practice per otto linguaggi di programmazione. Inclusa con Claude Code e disponibile anche per l’installazione dal repository skills.
Esempi di Skills personalizzate
Per esempi completi di Skills personalizzate, consulta l’Agent Skills Cookbook.
Conservazione dei dati
Le Agent Skills non sono coperte dagli accordi ZDR. Le definizioni delle Skills e i dati di esecuzione vengono conservati secondo la politica standard di conservazione dei dati di Anthropic.
Per la registrazione di audit delle operazioni della Skills API, consulta Registrazione di audit in Usare le Agent Skills con l’API.
Limitazioni e vincoli
Verifica questi limiti prima di creare o condividere una Skill. Su una piattaforma cloud, verifica anche la voce della tua piattaforma in Disponibilità per eventuali limiti di hosting o degli endpoint.
Disponibilità tra le diverse superfici
Le Skills personalizzate non si sincronizzano tra le superfici. Le Skills caricate su una superficie non sono automaticamente disponibili sulle altre:
- Le Skills caricate su claude.ai devono essere caricate separatamente nell’API.
- Le Skills caricate tramite l’API non sono disponibili su claude.ai.
- Le Skills di Claude Code sono basate sul filesystem e separate sia da claude.ai sia dall’API.
Gestisci e carica le Skills separatamente per ogni superficie in cui vuoi usarle.
Ambito di condivisione
Le Skills hanno modelli di condivisione diversi a seconda di dove le usi:
- Claude API: A livello di workspace. Tutti i membri del workspace possono accedere alle Skills caricate.
- Claude Code: Personali (
~/.claude/skills/) o di progetto (.claude/skills/). Possono anche essere condivise tramite i plugin di Claude Code. - Claude Models on Google Cloud (Anthropic managed): Ogni Skill appartiene a un solo workspace. Un ruolo IAM si applica a ogni workspace del progetto Google Cloud, quindi i workspace non separano chi può leggere, usare o gestire le Skills. Per un accesso separato, usa progetti separati, come descritto in Workspace in Claude Models on Google Cloud (Anthropic managed).
Vincoli dell’ambiente di runtime
L’esatto ambiente di runtime disponibile per la tua Skill dipende dalla superficie di prodotto in cui la usi.
- claude.ai:
- Accesso di rete variabile: A seconda delle impostazioni dell’utente/amministratore, le Skills potrebbero avere accesso di rete completo, parziale o nullo. Per maggiori dettagli, consulta l’articolo di supporto Creare e modificare file con Claude.
- Claude API:
- Nessun accesso di rete: Le Skills non possono effettuare chiamate API esterne né accedere a internet.
- Nessuna installazione di pacchetti in fase di esecuzione: Sono disponibili solo i pacchetti preinstallati. Non puoi installare nuovi pacchetti durante l’esecuzione.
- Solo dipendenze preconfigurate: Consulta la documentazione dello strumento di esecuzione del codice per l’elenco dei pacchetti disponibili.
- Claude Code:
- Accesso di rete completo: Le Skills hanno lo stesso accesso di rete di qualsiasi altro programma sul computer dell’utente.
- Installazione globale di pacchetti sconsigliata: Le Skills dovrebbero installare pacchetti solo localmente per evitare di interferire con il computer dell’utente.
Progetta le tue Skills in modo che funzionino entro questi vincoli.
Prossimi passi
Scopri come usare le Agent Skills per creare documenti con la Claude API in meno di 10 minuti.
Scopri come usare le Agent Skills per estendere le capacità di Claude tramite l’API.
Crea e gestisci Skills personalizzate in Claude Code.
Scopri come scrivere Skills efficaci che Claude possa individuare e usare con successo.
Disponibilità
Claude API
- API
- Messages API
- Managed Agents
- Modelli
- Tutti i modelli
Claude Platform on AWS
- API
- Messages API
- Managed Agents
- Modelli
- Tutti i modelli
Claude Models on Google Cloud (Anthropic managed)
- API
- Messages API
- Managed Agents
- Modelli
- Tutti i modelli
Microsoft Foundry (hosted on Anthropic)
- API
- Messages API
- Modelli
- Tutti i modelli
- Nota
Solo deployment Hosted on Anthropic; l’endpoint di download delle versioni delle skill (
GET /v1/skills/{skill_id}/versions/{version}/content) non è supportato su Foundry.
Gestione dei dati
Panoramica sulla gestione dei datiEndpoint applicabili
/v1/skills/v1/messagesconskills
Dati delle skill conservati secondo la policy standard. Scopri di più
Questa pagina ti è stata utile?