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.
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.
Resumo
- Ideia Central: Uma Habilidade é uma pequena pasta de instruções, construída em torno de um arquivo chamado
SKILL.md, que o Claude pode descobrir e carregar quando uma tarefa corresponde ao que a Habilidade cobre. - Por Que Importa: Substitui a digitação repetida do mesmo processo, checklist ou estilo da casa em cada nova conversa por um pacote reutilizável e portátil que o Claude encontra por conta própria.
- Conceitos Chave:
SKILL.md, correspondência de descrição, carregamento sob demanda, arquivos de referência empacotados, portabilidade entre interfaces. - Quando Usar: Qualquer tarefa que você faz da mesma maneira repetidamente - um formato de relatório recorrente, um checklist de revisão, uma convenção de nomenclatura, um processo passo a passo específico para sua equipe.
- Limitações / Trade-offs: Uma Habilidade só dispara quando sua descrição corresponde claramente à tarefa atual; uma descrição vaga ou excessivamente ampla significa que o Claude pode nunca carregá-la, ou carregá-la quando não deveria.
- Tópicos Relacionados: Instruções Personalizadas, Projetos, Frontmatter do SKILL.md, Descoberta de Habilidades.
Fundamentos
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.
Mecânicas e Interações
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.
Considerações Avançadas e Aplicações
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.
Concepções Errôneas Comuns
- "Uma Habilidade é basicamente um prompt salvo." - Um prompt salvo é um texto que você cola; uma Habilidade são instruções que o Claude encontra e carrega por conta própria, sem que você a nomeie.
- "Habilidades só funcionam no Claude Code." - Habilidades são portáteis entre Claude Code, Cowork e claude.ai; a mesma pasta se comporta da mesma maneira em cada interface.
- "Você tem que dizer ao Claude qual Habilidade usar." - Normalmente não; o Claude corresponde à tarefa com a descrição de uma Habilidade automaticamente. Você ainda pode referenciar uma pelo nome se quiser ser explícito.
- "Mais Habilidades instaladas significam melhores resultados." - Uma grande pilha de Habilidades vagamente descritas torna a descoberta mais difícil, não mais fácil, porque as descrições começam a se sobrepor.
- "Uma Habilidade precisa de código para ser útil." - Muitas Habilidades úteis são puramente instruções e regras de formatação, sem script ou código algum.
FAQs
Qual o mínimo que uma Habilidade precisa para existir?
- Uma pasta contendo um arquivo:
SKILL.md, com umnameedescriptionem seu frontmatter e instruções no corpo. - Arquivos de referência ou scripts empacotados são adições opcionais, não requisitos.
Eu preciso dizer ao Claude para usar uma Habilidade específica?
- Não - o Claude verifica novas tarefas contra as descrições de suas Habilidades disponíveis e carrega uma correspondência automaticamente.
- Você ainda pode nomear uma Habilidade diretamente em sua mensagem se quiser forçá-la ou ser explícito sobre qual delas você quer dizer.
Como uma Habilidade difere de simplesmente colar instruções no chat?
- Instruções coladas se aplicam uma vez, a essa mensagem; uma Habilidade é salva e recarrega automaticamente toda vez que uma tarefa correspondente surge, em qualquer conversa.
A mesma Habilidade pode ser usada no Claude Code e no claude.ai?
- Sim - Habilidades são portáteis entre Claude Code, Cowork e claude.ai, então uma Habilidade construída uma vez não precisa ser reconstruída por interface.
O que acontece se nenhuma Habilidade corresponder à minha solicitação?
- O Claude simplesmente responde normalmente, sem carregar nenhuma instrução de Habilidade - Habilidades só adicionam a uma conversa quando há uma correspondência.
Uma Habilidade pode incluir um script ou arquivo de referência, não apenas instruções?
- Sim - a pasta de uma Habilidade pode empacotar um documento de referência com detalhes extras, ou um script que a Habilidade tem permissão para executar, ao lado de
SKILL.md.
Para que serve o campo `allowed-tools`?
- É um campo opcional de frontmatter que delimita quais ferramentas uma Habilidade tem permissão para invocar, o que é mais relevante no Claude Code e Cowork.
Por que o campo de descrição é tão importante?
- É o que o Claude compara com as tarefas recebidas - uma descrição vaga significa que a Habilidade pode nunca carregar, mesmo que as instruções internas estejam boas.
Que tipos de tarefas são boas primeiras Habilidades?
- Relatórios recorrentes com formato fixo, checklists de revisão ou QA, e walkthroughs de integração são as primeiras Habilidades mais comuns que as equipes constroem.
Uma Habilidade é a mesma coisa que um Projeto?
- Não - um Projeto é um contexto e arquivos persistentes escopo a um espaço de trabalho, enquanto uma Habilidade é uma receita acionada por tarefa que pode se aplicar a qualquer conversa.
Uma Habilidade é a mesma coisa que Instruções Personalizadas?
- Não - Instruções Personalizadas se aplicam a todas as conversas o tempo todo, enquanto uma Habilidade só carrega quando sua descrição corresponde à tarefa atual.
Preciso saber programar para construir uma Habilidade?
- Não - o núcleo de uma Habilidade é um arquivo
SKILL.mdcom instruções em linguagem natural; scripts empacotados são opcionais e não necessários para a maioria das Habilidades.
Relacionados
- Noções Básicas de Habilidades de Agente - instale sua primeira Habilidade e veja a descoberta acontecer na prática
- Como o Claude Descobre e Carrega Habilidades Automaticamente - um olhar mais atento ao mecanismo de correspondência de descrição
- Habilidades vs Projetos vs Instruções Personalizadas: Qual a Diferença - quando usar cada um
- Anatomia de um Arquivo SKILL.md - o que vai no frontmatter e no corpo
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.