Skills
Anexe skills pré-construídas ou personalizadas a um agente no Claude Managed Agents para fornecer a ele expertise reutilizável, baseada em sistema de arquivos, para fluxos de trabalho específicos de domínio.
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 formas: 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 usa 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, então o nome de exibição da skill vem 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.ant apply envia o diretório skills/pr-summary, imprime o ID da nova skill e o registra em claude-lock.json. Faça commit de claude-lock.json para que o próximo ant apply envie suas edições como uma nova versão em vez de criar uma segunda skill.
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 Criar skillPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar.. Os pacotes de skills são enviados diretamente para a Skills API, e não 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:
| Campo | Descrição |
|---|---|
type | anthropic para skills pré-construídas ou custom para skills criadas no workspace. |
skill_id | O identificador da skill. Para skills da Anthropic, use o nome curto (por exemplo, xlsx). Para skills personalizadas, use o ID skill_* retornado na criação (consulte Criar uma skill personalizada). |
version | Fixe em uma versão específica ou use latest. Opcional. O padrão é latest quando omitido. Aplica-se tanto a skills da Anthropic quanto a skills personalizadas. |
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 ficar na sua base de código. Quando uma sessão monta um repositório por meio do recurso github_repository, um escaneamento do diretório .claude/skills na raiz do repositório é executado no início da sessão. Cada skill encontrada ali fica disponível para o agente. Você não precisa enviar essas skills nem adicioná-las ao array skills do agente. O agente recebe o nome, a descrição e o caminho no sandbox de cada skill descoberta. Quando uma tarefa corresponde, o agente lê o SKILL.md da skill, 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 de 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.mdscripts/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: umSKILL.mdsem 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 profundidadeskills/code-review/SKILL.md: um diretórioskillsfora 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 Permissões de token.
As skills descobertas seguem o estado do 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. O escaneamento é executado 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.
Skills de repositório funcionam junto com skills anexadas por meio do array skills do agente. Se uma skill de repositório compartilhar um nome com uma skill anexada, ou com uma skill de outro repositório montado, ambas ficam disponíveis. O agente recebe cada uma com seu próprio caminho.
Próximos passos
Personalize sandboxes na nuvem para suas sessões.
Aprenda a usar Agent Skills para estender as capacidades do Claude por meio da API.
Envie arquivos uma vez e referencie-os em várias requisições de API.
Aprenda a usar Agent Skills para criar documentos com a Claude API em menos de 10 minutos.
Esta página foi útil?