Skills

Le skill sono risorse riutilizzabili basate su filesystem che forniscono al tuo agente competenze specifiche di dominio: flussi di lavoro, contesto e best practice che trasformano un agente generico in uno specialista. Ogni skill che aggiungi comporta un costo modesto sulla "context window" (finestra di contesto) della sessione, aggiungendo istruzioni e metadati che aiutano il modello a usare la skill. Scopri di più nella panoramica di Agent Skills.

Puoi collegare due tipi di skill. Entrambi funzionano allo stesso modo: il tuo agente li invoca automaticamente quando sono rilevanti per il compito.

• Skill predefinite di Anthropic: Attività comuni sui documenti come la gestione di PowerPoint, Excel, Word e PDF (pptx, xlsx, docx, pdf).
• Skill personalizzate: Skill che crei e carichi nel tuo workspace.

Per imparare a creare skill personalizzate, consulta Agent Skills e Best practice per la creazione di skill. Per caricare una skill personalizzata nel tuo workspace, consulta Crea una skill personalizzata.



Crea una skill personalizzata

Una skill personalizzata è una directory contenente un file SKILL.md più eventuali file di supporto, caricata nel tuo workspace come archivio zip o come file individuali. La creazione della skill restituisce l'ID skill_* che referenzi quando la colleghi a un agente. Le skill predefinite di Anthropic sono già disponibili in ogni workspace e non richiedono questo passaggio. Per usare solo le skill predefinite, passa direttamente a Collega le skill a un agente.

Quando chiami direttamente la Skills API con cURL, passa esplicitamente l'header anthropic-beta: skills-2025-10-02. La CLI e gli SDK lo inviano automaticamente.

Questi esempi omettono il campo opzionale display_title, quindi il titolo della skill viene derivato da SKILL.md. Un display_title passato esplicitamente deve essere univoco tra le skill personalizzate nel tuo workspace.

ant beta:skills create \
  --file example_skill.zip

Per elencare, recuperare, eliminare e versionare le skill personalizzate, consulta Gestione delle skill personalizzate. Per gli schemi completi di richiesta e risposta, consulta il riferimento API Create Skill. I bundle delle skill vengono caricati direttamente nella Skills API anziché tramite la Files API.



Collega le skill a un agente

Collega le skill durante la creazione di un agente. Ogni sessione supporta fino a 500 skill in totale, conteggiate su tutti gli agenti della sessione (consulta Orchestrazione multiagente).

Ogni voce nell'array skills usa i seguenti campi:

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-5
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest
YAML



Prossimi passi