Comece a usar Agent Skills na API

Este tutorial mostra como usar Agent Skills para criar uma apresentação do PowerPoint. Você aprenderá como habilitar Skills, fazer uma requisição e acessar o arquivo gerado.

Pré-requisitos

• Uma chave de API do Claude ou uma ant CLI com login efetuado
• Um SDK cliente para a sua linguagem, ou curl e jq
• Familiaridade básica com a realização de requisições de API

Visão geral dos Agent Skills

Os Agent Skills pré-construídos estendem as capacidades do Claude com expertise especializada para tarefas como criar documentos, analisar dados e processar arquivos. A Anthropic fornece os seguintes Agent Skills pré-construídos na API:

• PowerPoint (pptx): Criar e editar apresentações
• Excel (xlsx): Criar e analisar planilhas
• Word (docx): Criar e editar documentos
• PDF (pdf): Gerar documentos PDF

Etapa 1: Listar os Skills disponíveis

Primeiro, verifique quais Skills estão disponíveis. Use a Skills API para listar todos os Skills gerenciados pela Anthropic. Cada aba de linguagem é um trecho de um único script contínuo, com quaisquer imports e configuração do cliente no topo:

# Listar Skills gerenciadas pela Anthropic
skills = client.skills.list(source="anthropic")

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

Você verá os seguintes Skills: pptx, xlsx, docx e pdf.

Esta API retorna os metadados de cada Skill: seu nome e descrição. O Claude carrega esses metadados na inicialização para determinar quais Skills estão disponíveis. Este é o primeiro nível de "progressive disclosure" (divulgação progressiva), em que o Claude descobre os Skills sem ainda carregar suas instruções completas.

Etapa 2: Criar uma apresentação

Use o Skill de PowerPoint para criar uma apresentação sobre energia renovável. Especifique os Skills usando o parâmetro container na Messages API:

# Criar uma mensagem com a Skill de 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)}")

A requisição inclui as seguintes partes:

• model: Um modelo que suporta a ferramenta de execução de código
• container.skills: Especifica quais Skills o Claude pode usar
• type: "anthropic": Indica que este é um Skill gerenciado pela Anthropic
• skill_id: "pptx": O identificador do Skill de PowerPoint
• version: "latest": A versão do Skill definida como a mais recentemente publicada
• tools: Habilita a execução de código (obrigatória para Skills)

Quando você faz essa requisição, o Claude associa automaticamente sua tarefa ao Skill relevante. Como você pediu uma apresentação, o Claude determina que o Skill de PowerPoint é relevante e carrega suas instruções completas: o segundo nível de divulgação progressiva. Em seguida, o Claude executa o código do Skill para criar sua apresentação.

Etapa 3: Baixar o arquivo criado

A apresentação foi criada no contêiner de execução de código e salva como um arquivo. A response da Etapa 2 inclui uma referência de arquivo com um ID de arquivo. Extraia o ID do arquivo e baixe o arquivo com a Files API. O exemplo o salva no diretório temporário do seu sistema:

# Extrair o ID do arquivo. A ferramenta de execução de código executa o código da Skill por meio
# de sua subferramenta Bash, e os arquivos gerados aparecem como itens bash_code_execution_output
# dentro do bloco 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:
    # Baixar o arquivo e salvá-lo
    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}")

Experimente mais exemplos

Experimente estas variações:

Criar uma planilha

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"}],
)

Criar um documento do 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"}],
)

Gerar um 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"}],
)

Próximos passos