Noções Básicas de Habilidades de Agente

10 exemplos para você começar com Habilidades de Agente - 7 básicas e 3 intermediárias.

Pré-requisitos

• Acesso a uma superfície Claude que suporte Habilidades - Claude Code, Cowork ou claude.ai.
• Nenhuma instalação especial além da sua conta e plano Claude normais - Habilidades são um recurso da superfície, não um produto separado.
• Uma tarefa recorrente em mente é o melhor ponto de partida: um formato de relatório, uma lista de verificação, uma convenção de nomenclatura ou qualquer processo que você se encontre explicando novamente.

Exemplos Básicos

1. Reconhecendo uma Tarefa que Vale a Pena Transformar em Habilidade

Nem toda pergunta única precisa de uma Habilidade - os bons candidatos são tarefas que você repete com a mesma forma todas as vezes.

Sinais de que uma tarefa é uma boa primeira Habilidade:
- Você explicou os mesmos passos ou formato para Claude mais de duas vezes.
- A saída precisa seguir uma estrutura específica todas as vezes (um relatório, uma lista de verificação, um modelo).
- Outra pessoa em sua equipe se beneficiaria das mesmas instruções.

• Uma Habilidade compensa na repetição - uma tarefa que você fará apenas uma vez não vale a pena empacotar.
• As primeiras Habilidades mais claras são aquelas com uma frase de gatilho óbvia, como "relatório semanal" ou "revisão de código".
• Se você não consegue descrever em uma frase quando gostaria que ela fosse acionada, vale a pena refinar a ideia antes de construí-la.
• Relatórios recorrentes, listas de verificação de revisão e guias de integração são os pontos de partida mais comuns que as equipes buscam.

2. Criando uma Pasta de Habilidade

Uma Habilidade começa como uma pasta com um único arquivo obrigatório dentro dela, chamado SKILL.md.

Pasta mínima de Habilidade:
relatorio-semanal/
  SKILL.md

• O nome da pasta não precisa corresponder exatamente a nada, mas um nome curto e descritivo torna sua biblioteca de Habilidades mais fácil de digitalizar posteriormente.
• SKILL.md é o único arquivo necessário - todo o resto na pasta é opcional.
• Onde esta pasta reside depende da superfície: um local de Habilidades em nível de projeto no Claude Code, uma área de Habilidades no Cowork ou uma seção de Habilidades nas configurações do seu claude.ai.
• Você não precisa reiniciar uma conversa para que uma nova Habilidade se torne disponível - uma vez adicionada, Claude pode encontrá-la na próxima tarefa correspondente.

3. Escrevendo o Frontmatter

SKILL.md abre com um pequeno bloco de metadados que informa ao Claude o que é a Habilidade e quando usá-la.

---
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.
---

• name é um identificador curto para a Habilidade - mantenha-o em minúsculas e específico.
• description é o campo que Claude realmente corresponde às tarefas recebidas, portanto, ele precisa declarar tanto o que a Habilidade faz quanto quando ela se aplica.
• Uma descrição que apenas diz o que a Habilidade faz, sem nomear quando usá-la, é a razão mais comum pela qual uma Habilidade não é utilizada.
• Duas ou três frases de gatilho concretas na descrição - as palavras que uma pessoa realmente digitaria - funcionam melhor do que um único nome de categoria abstrata.

4. Escrevendo o Corpo das Instruções

Abaixo do frontmatter, o restante de SKILL.md são instruções em linguagem clara sobre como realizar a tarefa.

Corpo de SKILL.md (após o frontmatter):
1. Puxe as três atualizações principais das notas desta semana.
2. Agrupe-as em Vitórias, Riscos e Próximos Passos.
3. Mantenha cada item com uma frase.
4. Termine com um resumo de uma linha para a liderança.

• Escreva o corpo da maneira que você explicaria a tarefa a um novo colega de equipe capaz - passos específicos, não objetivos vagos.
• Passos numerados funcionam bem para processos; prosa simples funciona bem para orientação de estilo ou tom.
• Você pode ser tão detalhado quanto a tarefa precisar - o corpo só carrega quando a Habilidade é acionada, então o comprimento aqui não atrasa conversas não relacionadas.
• Mantenha as instruções focadas em uma tarefa; uma Habilidade que tenta cobrir vários trabalhos não relacionados torna mais difícil para Claude corresponder de forma confiável.

5. Dando ao Claude uma Tarefa que Corresponde

Uma vez que uma Habilidade existe, você não a invoca pelo nome - você apenas pede a tarefa, e Claude a verifica em suas Habilidades.

Mensagem de exemplo:
"Você pode montar o relatório de status desta semana?"

• Se a redação em sua mensagem se sobrepõe à descrição da Habilidade, Claude carrega suas instruções antes de responder.
• Você nunca precisa dizer "use a habilidade de relatório semanal" - isso anula o propósito da descoberta automática.
• Na primeira vez que você testar uma nova Habilidade, use o tipo exato de redação que você espera usar em solicitações reais, não uma frase de teste genérica.
• Se a resposta não seguir o formato da Habilidade, isso é um sinal para revisitar a descrição ou as instruções, não um sinal de que as Habilidades não funcionam.

6. Confirmando que uma Habilidade Foi Usada

A maioria das superfícies mostra alguma indicação de que uma Habilidade foi carregada, para que você não fique adivinhando se ela foi acionada.

O que verificar:
- A saída segue a estrutura que você escreveu no corpo da Habilidade?
- A superfície mostra um indicador de Habilidade ou referência na resposta?
- Perguntar "qual Habilidade você usou para isso?" obtém uma resposta direta?

• A verificação mais confiável é simplesmente se a saída corresponde ao que você escreveu na Habilidade - se corresponder, ela foi acionada.
• Perguntar diretamente a Claude qual Habilidade ele usou é uma maneira legítima de confirmar, especialmente enquanto você ainda está testando uma nova.
• Se uma Habilidade não está sendo acionada quando deveria, a descrição é o primeiro lugar a procurar, não as instruções do corpo.
• Esse tipo de verificação rápida vale a pena fazer logo após criar qualquer nova Habilidade, antes de confiar nela para trabalho real.

7. Editando uma Habilidade Após o Fato

Habilidades não são fixas depois de criadas - você pode abrir SKILL.md e revisar as instruções ou a descrição a qualquer momento.

Edições iniciais comuns:
- Aperfeiçoando a descrição após notar que a Habilidade não disparou.
- Adicionando um passo que você esqueceu na primeira vez.
- Removendo uma instrução que produziu o formato errado.

• Não há um passo separado de "publicar" - salvar o arquivo editado é suficiente para que a próxima tarefa correspondente use a nova versão.
• No início, espere revisar a descrição mais do que o corpo - fazer Claude reconhecer o gatilho de forma confiável geralmente é a parte mais difícil.
• Edições pequenas e específicas após observar um resultado real são mais eficazes do que tentar escrever uma Habilidade perfeita na primeira tentativa.
• Manter uma Habilidade em um só lugar significa que uma edição a atualiza em todos os lugares onde essa Habilidade é usada, em vez de precisar corrigir cópias espalhadas.

Exemplos Intermediários

8. Empacotando um Arquivo de Referência

A pasta de uma Habilidade pode conter mais do que SKILL.md - arquivos adicionais viajam com ela e podem ser referenciados a partir das instruções.

Pasta de Habilidade com um arquivo de referência:
relatorio-semanal/
  SKILL.md
  modelo-relatorio.md

• Mova material longo e detalhado - como um modelo completo ou guia de estilo - para um arquivo de referência separado, e mantenha o corpo de SKILL.md focado nos passos.
• Isso mantém as instruções principais fáceis de digitalizar, ao mesmo tempo que fornece a Claude acesso a tantos detalhes quanto a tarefa necessita.
• Arquivos de referência são opcionais; a maioria das Habilidades simples nunca precisa de um.
• É aqui também que um pequeno script pode residir, se o escopo allowed-tools da Habilidade permitir que Claude o execute.

Relacionado: Anatomia de um Arquivo SKILL.md - o que pertence ao frontmatter versus ao corpo versus a um arquivo empacotado

9. Escrevendo uma Descrição que Dispara Confiável

O campo de descrição vale uma segunda passada depois que você viu como a Habilidade se comporta na prática.

Antes: "Lida com relatórios."
Depois: "Gera o relatório de status semanal da equipe em nosso formato padrão.
Use quando solicitado uma atualização semanal, relatório de status ou resumo da equipe."

• Uma descrição vaga como "lida com relatórios" dá a Claude muito pouco para corresponder e muitas vezes não é utilizada.
• A versão revisada declara o que a Habilidade faz e lista as frases específicas que uma pessoa realmente digitaria para pedi-la.
• Se as descrições de duas Habilidades se sobrepuserem muito, Claude pode escolher a errada - refinar cada descrição reduz esse risco.
• Esta é a edição de maior alavancagem que você pode fazer em uma Habilidade que não está disparando quando esperado.

Relacionado: Como Claude Descobre e Carrega Habilidades Automaticamente - a mecânica por trás de por que a redação da descrição importa tanto

10. Usando a Mesma Habilidade em Diferentes Superfícies

Uma Habilidade construída uma vez não está vinculada a uma única superfície Claude - a mesma pasta funciona da mesma maneira no Claude Code, Cowork e claude.ai.

Uma Habilidade, três superfícies:
- Claude Code: dispara enquanto trabalha em um repositório.
- Cowork: dispara durante uma tarefa de espaço de trabalho em equipe.
- claude.ai: dispara em uma conversa comum.

• Você não precisa de uma versão separada de uma Habilidade para cada superfície - o mecanismo de correspondência de descrição se comporta da mesma forma em todos os lugares.
• Isso torna as Habilidades um bom lugar para colocar convenções de equipe que você deseja que sejam seguidas consistentemente, independentemente da superfície em que alguém esteja trabalhando.
• Onde a Habilidade é armazenada e como ela é habilitada difere ligeiramente por superfície - o conteúdo e o comportamento da Habilidade, uma vez carregados, não.
• Se uma Habilidade funciona bem em uma superfície, mas não em outra, a causa é quase sempre uma configuração de habilitação, não a Habilidade em si.

Relacionado: Habilitando e Gerenciando Habilidades em Claude Code, Cowork e Claude.ai - onde ativar Habilidades por superfície

Versões da Stack: Escrito contra a linha de modelos Claude atual em aproximadamente 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 de produtos mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.