MessagesSkills

Comece com Agent Skills na API

Aprenda como usar Agent Skills para criar documentos com a API do Claude em menos de 10 minutos.

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

Pré-requisitos

Chave de API do Claude
Python 3.7+ ou curl instalado
Familiaridade básica com solicitações de API

Visão geral de Agent Skills

As Agent Skills pré-construídas estendem as capacidades do Claude com conhecimento especializado para tarefas como criar documentos, analisar dados e processar arquivos. A Anthropic fornece as seguintes Agent Skills pré-construídas na API:

PowerPoint (pptx): Crie e edite apresentações
Excel (xlsx): Crie e analise planilhas
Word (docx): Crie e edite documentos
PDF (pdf): Gere documentos PDF

Quer criar Skills personalizadas? Consulte o Agent Skills Cookbook para exemplos de como construir suas próprias Skills com conhecimento específico de domínio.

Passo 1: Liste as Skills disponíveis

Primeiro, verifique quais Skills estão disponíveis. Use a API de Skills para listar todas as Skills gerenciadas pela Anthropic:

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

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

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

Passo 2: Crie uma apresentação

Agora use a Skill do PowerPoint para criar uma apresentação sobre energia renovável. Especifique as Skills usando o parâmetro container na API de Messages:

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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)}")

Vamos detalhar o que cada parte faz:

container.skills: Especifica quais Skills Claude pode usar
type: "anthropic": Indica que esta é uma Skill gerenciada pela Anthropic
skill_id: "pptx": O identificador da Skill do PowerPoint
version: "latest": A versão da Skill definida como a mais recentemente publicada
tools: Habilita a execução de código (necessária para Skills)
Cabeçalho beta: skills-2025-10-02

Os exemplos aqui usam a versão da ferramenta code_execution_20260521, que está disponível de forma geral e não requer nenhum cabeçalho beta de execução de código. As Skills também funcionam com versões mais antigas da ferramenta de execução de código (como code_execution_20250825); qualquer versão da ferramenta de execução de código satisfaz o requisito das Skills. Seja qual for a versão que você usar, mantenha o type da ferramenta e qualquer cabeçalho beta consistentes com a página da ferramenta de execução de código, e sempre inclua skills-2025-10-02.

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

Passo 3: Baixe o arquivo criado

A apresentação foi criada no contêiner de execução de código e salva como um arquivo. A resposta inclui uma referência de arquivo com um ID de arquivo. Extraia o ID do arquivo e baixe-o usando a API de Files:

# 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.beta.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Para detalhes completos sobre como trabalhar com arquivos gerados, consulte a documentação da ferramenta de execução de código.

Experimente mais exemplos

Agora que você criou seu primeiro documento com Skills, experimente estas variações:

Crie uma planilha

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Crie um documento do Word

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Gere um PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Próximos passos

Agora que você usou Agent Skills pré-construídas, você pode:

Guia da API

Use Skills com a API do Claude

Crie Skills personalizadas

Envie suas próprias Skills para tarefas especializadas

Guia de criação

Aprenda as melhores práticas para escrever Skills eficazes

Use Skills no Claude Code

Saiba mais sobre Skills no Claude Code

Agent Skills Cookbook

Explore exemplos de Skills e padrões de implementação

Was this page helpful?

MessagesSkills

Comece com Agent Skills na API

Aprenda como usar Agent Skills para criar documentos com a API do Claude em menos de 10 minutos.

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

Pré-requisitos

Chave de API do Claude
Python 3.7+ ou curl instalado
Familiaridade básica com solicitações de API

Visão geral de Agent Skills

PowerPoint (pptx): Crie e edite apresentações
Excel (xlsx): Crie e analise planilhas
Word (docx): Crie e edite documentos
PDF (pdf): Gere documentos PDF

Quer criar Skills personalizadas? Consulte o Agent Skills Cookbook para exemplos de como construir suas próprias Skills com conhecimento específico de domínio.

Passo 1: Liste as Skills disponíveis

Primeiro, verifique quais Skills estão disponíveis. Use a API de Skills para listar todas as Skills gerenciadas pela Anthropic:

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

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

Passo 2: Crie uma apresentação

Agora use a Skill do PowerPoint para criar uma apresentação sobre energia renovável. Especifique as Skills usando o parâmetro container na API de Messages:

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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)}")

Vamos detalhar o que cada parte faz:

container.skills: Especifica quais Skills Claude pode usar
type: "anthropic": Indica que esta é uma Skill gerenciada pela Anthropic
skill_id: "pptx": O identificador da Skill do PowerPoint
version: "latest": A versão da Skill definida como a mais recentemente publicada
tools: Habilita a execução de código (necessária para Skills)
Cabeçalho beta: skills-2025-10-02

Passo 3: Baixe o arquivo criado

# 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.beta.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Para detalhes completos sobre como trabalhar com arquivos gerados, consulte a documentação da ferramenta de execução de código.

Experimente mais exemplos

Agora que você criou seu primeiro documento com Skills, experimente estas variações:

Crie uma planilha

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Crie um documento do Word

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Gere um PDF

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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"}],
)

Próximos passos

Agora que você usou Agent Skills pré-construídas, você pode:

Guia da API

Use Skills com a API do Claude

Crie Skills personalizadas

Envie suas próprias Skills para tarefas especializadas

Guia de criação

Aprenda as melhores práticas para escrever Skills eficazes

Use Skills no Claude Code

Saiba mais sobre Skills no Claude Code

Agent Skills Cookbook

Explore exemplos de Skills e padrões de implementação

Was this page helpful?

Pré-requisitos

Visão geral de Agent Skills

Passo 1: Liste as Skills disponíveis

Passo 2: Crie uma apresentação

Passo 3: Baixe o arquivo criado

Experimente mais exemplos

Crie uma planilha

Crie um documento do Word

Gere um PDF

Próximos passos

Pré-requisitos

Visão geral de Agent Skills

Passo 1: Liste as Skills disponíveis

Passo 2: Crie uma apresentação

Passo 3: Baixe o arquivo criado

Experimente mais exemplos

Crie uma planilha

Crie um documento do Word

Gere um PDF

Próximos passos

Pré-requisitos

Visão geral de Agent Skills

Passo 1: Liste as Skills disponíveis

Passo 2: Crie uma apresentação

Passo 3: Baixe o arquivo criado

Experimente mais exemplos

Crie uma planilha

Crie um documento do Word

Gere um PDF

Próximos passos

Pré-requisitos

Visão geral de Agent Skills

Passo 1: Liste as Skills disponíveis

Passo 2: Crie uma apresentação

Passo 3: Baixe o arquivo criado

Experimente mais exemplos

Crie uma planilha

Crie um documento do Word

Gere um PDF

Próximos passos