O Que São Habilidades de Agente?
Habilidades de Agente são receitas baseadas em pastas que o Claude carrega sob demanda para guiar como ele executa uma tarefa.
//
Busque em todas as páginas da documentação
Habilidades de Agente são receitas baseadas em pastas que o Claude carrega sob demanda para guiar como ele executa uma tarefa.
Em vez de reexplicar seu processo toda vez que você pede um relatório semanal, uma revisão de código ou um walkthrough de integração, você escreve as instruções uma vez como uma Habilidade.
A partir daí, o Claude reconhece quando uma solicitação corresponde a essa Habilidade e carrega automaticamente as instruções completas, sem que você precise referenciá-la pelo nome.
SKILL.md, que o Claude pode descobrir e carregar quando uma tarefa corresponde ao que a Habilidade cobre.SKILL.md, correspondência de descrição, carregamento sob demanda, arquivos de referência empacotados, portabilidade entre interfaces.Em sua forma mais simples, uma Habilidade é uma pasta.
Dentro dessa pasta fica um arquivo obrigatório, SKILL.md, que contém um pequeno bloco de metadados seguido por instruções em linguagem natural no corpo.
Os metadados dizem ao Claude qual é o nome da Habilidade e, o mais importante, descrevem o que ela faz e quando deve ser usada.
O corpo é onde a receita real vive - os passos, o formato, as regras da casa que você quer que sejam seguidas toda vez que esse tipo de tarefa surgir.
Uma Habilidade também pode empacotar arquivos extras ao lado de SKILL.md, como um documento de referência com mais detalhes do que cabe nas instruções principais, ou um pequeno script que a Habilidade tem permissão para executar.
Pense em uma Habilidade como um auxílio de trabalho que você entrega a um novo membro da equipe, exceto que o Claude o lê automaticamente em vez de precisar ser instruído a abri-lo.
Você não invoca uma Habilidade da maneira que executaria um comando.
O Claude escaneia as descrições de todas as suas Habilidades disponíveis contra a tarefa à sua frente e carrega aquela que corresponde.
Essa distinção - uma Habilidade é descoberta, não invocada - é a coisa mais importante a entender sobre como as Habilidades se comportam no dia a dia.
A descrição de uma Habilidade está fazendo mais trabalho do que parece.
O Claude não lê as instruções completas de cada Habilidade em cada mensagem - isso seria lento e poluiria a conversa com material irrelevante.
Em vez disso, ele mantém um índice leve do que cada Habilidade disponível serve, construído a partir do campo de descrição, e verifica novas tarefas contra esse índice.
Quando a linguagem de uma tarefa se alinha com a descrição de uma Habilidade, o Claude carrega o corpo completo do SKILL.md dessa Habilidade na conversa antes de começar a trabalhar.
É por isso que a descrição importa mais do que quase qualquer outra coisa sobre uma Habilidade: é o gatilho, não apenas um rótulo.
Uma forma ilustrativa curta do que esses metadados parecem:
---
name: weekly-report
description: >-
Generates the weekly team status report in our standard format.
Use when asked for a weekly update, status report, or team summary.
allowed-tools: []
---Note que a descrição acima declara tanto o que a Habilidade faz quanto quando usá-la - nomeando as frases gatilho que uma pessoa realmente digitaria, não apenas um rótulo de categoria.
Um campo opcional allowed-tools pode delimitar quais ferramentas uma Habilidade tem permissão para usar, o que é mais relevante no Claude Code e Cowork do que na interface web do claude.ai, onde o acesso a ferramentas já é restrito pela própria interface.
As Habilidades são portáteis por design: a mesma pasta funciona se o Claude estiver rodando no Claude Code, no Cowork ou na interface de chat do claude.ai, porque o mecanismo subjacente - correspondência de descrição, depois carregamento de instruções - é o mesmo em todos os lugares.
As Habilidades ficam ao lado de outras duas maneiras de dar ao Claude contexto permanente: Projetos e Instruções Personalizadas.
Cada uma resolve uma forma diferente de problema, e a distinção útil é entre contexto que deve estar sempre presente e contexto que só deve carregar quando relevante.
| Abordagem | Força | Fraqueza | Melhor Uso |
|---|---|---|---|
| Habilidade de Agente | Carrega apenas quando a tarefa corresponde; portátil entre interfaces | Só é tão boa quanto sua descrição; invisível se o gatilho for vago | Uma tarefa ou processo recorrente com um gatilho claro e nomeável |
| Projeto | Mantém arquivos e contexto escopo a um espaço de trabalho, sempre disponível dentro dele | Vinculado a um único espaço de trabalho; não é algo que o Claude busca ao corresponder uma descrição | Trabalho contínuo vinculado a um cliente, codebase ou iniciativa |
| Instruções Personalizadas | Aplica-se amplamente, a cada conversa, sem necessidade de correspondência | Sempre ativo, então não pode permanecer restrito a uma tarefa sem se tornar ruído | Preferências permanentes que você deseja que sejam seguidas o tempo todo, em todos os lugares |
As primeiras Habilidades de uma equipe geralmente são as tarefas que eles já fazem da mesma maneira toda vez: um relatório semanal com uma estrutura fixa, um checklist de revisão de código, um walkthrough de integração para novos contratados.
Esses são bons pontos de partida porque o gatilho é óbvio e o retorno é imediato - na próxima vez que alguém pedir esse relatório, o Claude já saberá o formato sem precisar ser informado novamente.
À medida que uma biblioteca de Habilidades cresce, a disciplina que mais importa é manter a descrição de cada Habilidade específica o suficiente para que não se sobreponha de forma confusa a outra Habilidade que cobre um terreno semelhante.
SKILL.md, com um name e description em seu frontmatter e instruções no corpo.SKILL.md.SKILL.md com instruções em linguagem natural; scripts empacotados são opcionais e não necessários para a maioria das Habilidades.Versões da Stack: Escrito com base na linha de modelos Claude atual em ~junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos do produto mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026