Skill

Le "skill" (competenze) sono risorse riutilizzabili basate su filesystem che forniscono al tuo agente competenze specifiche del 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à una tantum), le skill vengono caricate su richiesta, influendo sulla "context window" (finestra di contesto) solo quando necessario.

Puoi collegare due tipi di skill. Entrambi funzionano allo stesso modo: il tuo agente le invoca automaticamente quando sono rilevanti per l'attività.

• 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 Creare una skill personalizzata.



Creare 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_* a cui fai riferimento quando la colleghi a un agente. Le skill predefinite di Anthropic sono già disponibili in ogni workspace e non richiedono questo passaggio. Per utilizzare solo le skill predefinite, passa direttamente a Collegare le skill a un agente.

Quando chiami direttamente la Skills API con cURL o la CLI, passa esplicitamente l'header anthropic-beta: skills-2025-10-02. 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 \
  --beta skills-2025-10-02

Per elencare, recuperare, eliminare e gestire le versioni delle 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.



Collegare le skill a un agente

Collega le skill quando crei un agente. Ogni sessione supporta fino a 20 skill in totale, conteggiate su tutti gli agenti nella sessione (consulta Sessioni multi-agente).

Ogni voce nell'array skills utilizza i seguenti campi:

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



Passaggi successivi