Skills

Skills são recursos reutilizáveis, baseados em sistema de arquivos, que dão 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. Cada skill que você adiciona incorre em um custo modesto na "context window" (janela de contexto) da sessão, adicionando instruções e metadados que ajudam o modelo a usar a skill. Saiba mais na visão geral de Agent Skills.

As skills chegam ao seu agente de duas maneiras: anexe-as por meio do array skills do agente ou carregue-as de um repositório GitHub montado na sessão. As skills anexadas vêm em dois tipos. Todas as skills funcionam da mesma forma: seu agente as invoca automaticamente quando são relevantes para a tarefa.

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

Para aprender a criar skills personalizadas, consulte Agent Skills e Melhores práticas de criação de skills. Para enviar 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. Criar a 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.

Estes exemplos omitem o campo opcional display_name, portanto o nome de exibição da skill é derivado do campo name em SKILL.md. Um display_name explícito pode ter até 255 caracteres e não precisa ser único dentro do seu workspace.

ant apply skills/pr-summary

---
name: pr-summary
description: Summarize a pull request's changes and risks in the team's review format.
---

# PR summary

List what changed, why, and anything a reviewer should look at closely, in three short sections.

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 em vez de passar pela Files API.

Anexar skills a um agente

Anexe skills ao criar um agente. Cada sessão suporta até 500 skills, contadas como o conjunto deduplicado entre todos os agentes na sessão (consulte Orquestração multiagente).

Cada entrada no array skills usa os seguintes campos:

ant apply agent.md

---
name: Financial Analyst
model: claude-opus-5-5
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest
---

You are a financial analysis agent.

Carregar skills de um repositório GitHub

As skills também podem residir na sua base de código. Quando uma sessão monta um repositório por meio do recurso github_repository, o diretório .claude/skills na raiz do repositório é verificado no início da sessão, e cada skill encontrada ali fica disponível para o agente. Nenhum envio e nenhuma entrada no array skills do agente são necessários. O agente vê o nome, a descrição e o caminho no sandbox de cada skill descoberta, e lê o SKILL.md da skill quando uma tarefa corresponde, incluindo quaisquer scripts e recursos que a skill inclua. A descoberta depende da ferramenta read do agente, do conjunto de ferramentas do agente, que é habilitada por padrão; um agente com read desabilitada não carrega skills do repositório.

A descoberta encontra skills exatamente em .claude/skills/<skill-name>/SKILL.md, um nível de diretório de profundidade na raiz do repositório:

• your-repo/
  • .claude/
    • skills/
      • code-review/
        • SKILL.md
      • release-process/
        • SKILL.md
        • scripts/
          • run_checks.sh
  • src/

Locais que não correspondem a este layout não são descobertos no início da sessão:

• .claude/skills/SKILL.md: um SKILL.md sem um diretório de skill ao seu redor
• .claude/skills/tools/code-review/SKILL.md: aninhado a mais de um nível de diretório de profundidade
• skills/code-review/SKILL.md: um diretório skills fora de .claude

Um diretório .claude/skills em outro lugar do repositório, como dentro de um subdiretório de pacote, não é anunciado no início da sessão; essas skills ainda podem aparecer quando o agente lê arquivos sob essa subárvore.

As skills de repositório usam o mesmo formato SKILL.md das skills personalizadas que você envia. Para o formato e orientações de criação, consulte Agent Skills e Melhores práticas de criação de skills.

Para carregar skills de um repositório, crie uma sessão que o monte. Esta é a mesma requisição mostrada em Acessando o GitHub; mount_path é opcional e o padrão é /workspace/<repo-name>:

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "github_repository",
            "url": "https://github.com/org/repo",
            "mount_path": "/workspace/repo",
            "authorization_token": "ghp_your_github_token",
        },
    ],
)

Para repositórios privados, o authorization_token do recurso deve ter acesso ao repositório. Este é o mesmo fluxo de token de acesso pessoal usado para qualquer montagem de repositório; consulte Acessando o GitHub.

As skills descobertas seguem o estado de checkout do repositório: o branch ou commit de checkout quando o recurso define um, caso contrário o branch padrão do repositório. A verificação é executada uma vez, quando a sessão inicia. Commits enviados no meio da sessão não são detectados; para carregar skills atualizadas, inicie uma nova sessão.

As skills de repositório funcionam junto com as skills anexadas por meio do array skills do agente. Se uma skill de repositório compartilha um nome com uma skill anexada, ou com uma skill de outro repositório montado, ambas ficam disponíveis; cada uma é anunciada com seu próprio caminho.

Próximos passos