Inizia con le Agent Skills nell'API

Questo tutorial ti mostra come usare le Agent Skills per creare una presentazione PowerPoint. Imparerai come abilitare le 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 delle Agent Skills

Le Agent Skills predefinite 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 le seguenti Agent Skills predefinite 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



Passo 1: Elenca le Skills disponibili

Per prima cosa, verifica quali Skills sono disponibili. Usa l'API Skills per elencare tutte le Skills gestite da Anthropic. Ogni scheda di linguaggio è un estratto di un unico script continuo, con eventuali import e configurazione del client all'inizio:

# List Anthropic-managed Skills
ant skills list --source anthropic

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

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



Passo 2: Crea una presentazione

Usa la Skill PowerPoint per creare una presentazione sull'energia rinnovabile. Specifica le Skills usando il parametro container nella Messages API:

# Create a message with the PowerPoint Skill
response = client.messages.create(
    model="claude-opus-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 una Skill gestita da Anthropic
• skill_id: "pptx": L'identificatore della Skill PowerPoint
• version: "latest": La versione della Skill impostata sulla più recente pubblicata
• tools: Abilita l'esecuzione del codice (richiesta per le Skills)
• Header beta: skills-2025-10-02

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



Passo 3: Scarica il file creato

La presentazione è stata creata nel container di esecuzione del codice e salvata come file. La response del Passo 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:

# Extract the file ID. The code execution tool runs the Skill's code through
# its Bash sub-tool, and generated files appear as bash_code_execution_output
# items inside the bash_code_execution_tool_result block.
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:
    # Download the file and save it
    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.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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