Skills

Skills são recursos reutilizáveis e baseados em sistema de arquivos que fornecem ao seu agente expertise específica de domínio: fluxos de trabalho, contexto e melhores práticas que transformam um agente de propósito geral em um especialista. Diferentemente de prompts (instruções no nível da conversa para tarefas pontuais), as skills são carregadas sob demanda, impactando a "context window" (janela de contexto) apenas quando necessário.

Você pode anexar dois tipos de skill. Ambos funcionam da mesma forma: seu agente os invoca automaticamente quando são relevantes para a tarefa.

• Skills pré-construídas da Anthropic: Tarefas comuns de documentos, como manipulação de PowerPoint, Excel, Word e PDF (pptx, xlsx, docx, pdf).
• Skills personalizadas: Skills que você cria e faz upload para o seu workspace.

Para aprender a criar skills personalizadas, consulte Agent Skills e Melhores práticas para criação de skills. Para fazer upload de uma skill personalizada para o seu workspace, consulte Criar uma skill personalizada.



Criar uma skill personalizada

Uma skill personalizada é um diretório contendo um arquivo SKILL.md mais quaisquer arquivos de suporte, enviado para o seu workspace como um arquivo zip ou como arquivos individuais. A criação da skill retorna o ID skill_* que você referencia ao anexá-la a um agente. As skills pré-construídas da Anthropic já estão disponíveis em todos os workspaces e não exigem esta etapa. Para usar apenas skills pré-construídas, pule para Anexar skills a um agente.

Ao chamar a Skills API diretamente com cURL ou a CLI, passe o cabeçalho anthropic-beta: skills-2025-10-02 explicitamente. Os SDKs o enviam automaticamente.

Estes exemplos omitem o campo opcional display_title, então o título da skill é derivado do SKILL.md. Um display_title passado explicitamente deve ser único entre as skills personalizadas no seu workspace.

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

Para listar, recuperar, excluir e versionar skills personalizadas, consulte Gerenciando skills personalizadas. Para os esquemas completos de requisição e resposta, consulte a referência da API Create Skill. Os pacotes de skills são enviados diretamente para a Skills API, e não através da Files API.



Anexar skills a um agente

Anexe skills ao criar um agente. Cada sessão suporta até 20 skills no total, contadas entre todos os agentes na sessão (consulte Sessões multiagente).

Cada entrada no array skills usa os seguintes campos:

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



Próximos passos