Inizia a usare gli Agent Skills nell'API

Questo tutorial ti mostra come usare gli Agent Skills per creare una presentazione PowerPoint. Imparerai come abilitare gli Skills, effettuare una richiesta e accedere al file generato.

Prerequisiti

• Una chiave API di Claude o una CLI ant con accesso effettuato
• Un SDK client per il tuo linguaggio, oppure curl e jq
• Familiarità di base con l'esecuzione di richieste API

Panoramica degli Agent Skills

Gli Agent Skills predefiniti estendono le capacità di Claude con competenze specializzate per attività come la creazione di documenti, l'analisi di dati e l'elaborazione di file. Anthropic fornisce i seguenti Agent Skills predefiniti nell'API:

• PowerPoint (pptx): Crea e modifica presentazioni
• Excel (xlsx): Crea e analizza fogli di calcolo
• Word (docx): Crea e modifica documenti
• PDF (pdf): Genera documenti PDF

Passaggio 1: Elenca gli Skills disponibili

Per prima cosa, verifica quali Skills sono disponibili. Usa la Skills API per elencare tutti gli Skills gestiti da Anthropic. Ogni scheda di linguaggio è un estratto di un unico script continuo, con eventuali import e configurazione del client in cima:

# Elenca le Skill gestite da Anthropic
skills = client.skills.list(source="anthropic")

for skill in skills.data:
    print(f"{skill.id}: {skill.display_name}")

Vedrai i seguenti Skills: pptx, xlsx, docx e pdf.

Questa API restituisce i metadati di ciascuno Skill: il suo nome e la sua descrizione. Claude carica questi metadati all'avvio per determinare quali Skills sono disponibili. Questo è il primo livello della "progressive disclosure" (divulgazione progressiva), in cui Claude scopre gli Skills senza ancora caricarne le istruzioni complete.

Passaggio 2: Crea una presentazione

Usa lo Skill PowerPoint per creare una presentazione sulle energie rinnovabili. Specifica gli Skills usando il parametro container nella Messages API:

# Crea un messaggio con la Skill PowerPoint
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create a presentation about renewable energy with 5 slides",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

La richiesta include le seguenti parti:

• model: Un modello che supporta lo strumento di esecuzione del codice
• container.skills: Specifica quali Skills Claude può usare
• type: "anthropic": Indica che si tratta di uno Skill gestito da Anthropic
• skill_id: "pptx": L'identificatore dello Skill PowerPoint
• version: "latest": La versione dello Skill impostata sulla più recente pubblicata
• tools: Abilita l'esecuzione del codice (richiesta per gli Skills)

Quando effettui questa richiesta, Claude abbina automaticamente la tua attività allo Skill pertinente. Poiché hai chiesto una presentazione, Claude determina che lo Skill PowerPoint è pertinente e ne carica le istruzioni complete: il secondo livello della divulgazione progressiva. Quindi Claude esegue il codice dello Skill per creare la tua presentazione.

Passaggio 3: Scarica il file creato

La presentazione è stata creata nel container di esecuzione del codice e salvata come file. La response del Passaggio 2 include un riferimento al file con un ID file. Estrai l'ID file e scarica il file con la Files API. L'esempio lo salva nella directory temporanea del tuo sistema:

# Estrai l'ID del file. Lo strumento di esecuzione del codice esegue il codice della Skill tramite
# il suo sotto-strumento Bash, e i file generati appaiono come elementi bash_code_execution_output
# all'interno del blocco bash_code_execution_tool_result.
file_id = None
for block in response.content:
    if block.type == "bash_code_execution_tool_result":
        if block.content.type == "bash_code_execution_result":
            for output in block.content.content:
                file_id = output.file_id

if file_id:
    # Scarica il file e salvalo
    output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
    file_content = client.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Prova altri esempi

Prova queste varianti:

Crea un foglio di calcolo

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create a quarterly sales tracking spreadsheet with sample data",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Crea un documento Word

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "docx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Write a 2-page report on the benefits of renewable energy",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Genera un PDF

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Generate a PDF invoice template",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Prossimi passi