//
Busque em todas as páginas da documentação
Claude escaneia as descrições de Habilidades para corresponder a tarefas recebidas e carregar instruções correspondentes sob demanda.
Este é o mecanismo que permite criar uma biblioteca de Habilidades sem ter que nomear uma toda vez que você deseja que ela seja usada.
Entender como a correspondência realmente funciona é a maneira mais rápida de corrigir uma Habilidade que não está sendo acionada ou de escrever uma nova que funcionará.
Cada Habilidade que você torna disponível para Claude tem duas partes que importam para a descoberta: seu nome e, muito mais importante, sua descrição.
Claude não lê todas as instruções completas de cada Habilidade a cada mensagem - isso adicionaria um comprimento desnecessário a cada conversa, a maioria das quais não precisa de nenhuma Habilidade.
Em vez disso, ele mantém algo mais próximo de um índice: o nome e a descrição de cada Habilidade, mantidos de forma leve o suficiente para serem verificados rapidamente contra o que você acabou de pedir.
Quando sua mensagem chega, Claude a compara com esse índice, procurando uma descrição que corresponda à forma da tarefa.
Se uma corresponder, Claude carrega o corpo completo da Habilidade (SKILL.md) - os passos reais, formato ou regras - em seu contexto de trabalho antes de começar a processar sua solicitação.
Se nada corresponder, Claude simplesmente responde normalmente, sem nenhuma Habilidade envolvida.
Este processo de duas etapas - uma verificação barata contra descrições curtas, seguida por um carregamento completo apenas em caso de correspondência - é o motivo pelo qual você pode ter muitas Habilidades disponíveis sem que cada conversa fique lenta ou confusa com instruções irrelevantes.
O campo de descrição está realizando o trabalho real de descoberta, e vale a pena ser preciso sobre o que a torna eficaz.
Uma boa descrição declara duas coisas: o que a Habilidade faz e quando ela deve ser usada - idealmente usando o tipo de palavras que uma pessoa digitaria naturalmente ao solicitar essa tarefa.
description: >-
Generates the weekly team status report in our standard format.
Use when asked for a weekly update, status report, or team summary.Note que esta descrição não diz apenas "lida com relatórios" - ela nomeia a tarefa específica e lista três formulações que alguém poderia realmente usar para solicitá-la.
Essa especificidade importa porque Claude está comparando com a linguagem real da tarefa, não com um rótulo de categoria que você tinha em mente ao escrevê-la.
Uma descrição muito ampla corre o risco de ser acionada em tarefas para as quais não foi destinada; uma descrição muito restrita ou abstrata corre o risco de nunca ser acionada, mesmo na tarefa exata para a qual foi criada.
Quando mais de uma descrição de Habilidade poderia cobrir plausivelmente a mesma solicitação, Claude tem que escolher - é por isso que manter as descrições distintas umas das outras é importante à medida que sua biblioteca de Habilidades cresce, não apenas manter cada uma delas individualmente clara.
O corpo das instruções, em contraste, não precisa ser otimizado para correspondência - ele só é lido depois que uma Habilidade já foi selecionada, então pode ser tão longo e detalhado quanto a tarefa realmente exige.
À medida que a biblioteca de Habilidades de uma equipe cresce além de um punhado de entradas, a confiabilidade da descoberta se torna um problema de design, não apenas um ajuste de formulação.
| Situação | O que Acontece | Correção |
|---|---|---|
| Descrição muito vaga ("lida com relatórios") | Raramente ou nunca corresponde a solicitações reais | Adicione frases de acionamento concretas que alguém realmente digitaria |
| Duas Habilidades com descrições sobrepostas | Claude pode escolher a errada, de forma inconsistente | Restrinja a descrição de cada uma ao seu gatilho distinto |
| Descrição precisa, mas instruções superficiais | A Habilidade dispara corretamente, mas a saída não corresponde às expectativas | Este não é um problema de descoberta - revise o corpo, não a descrição |
| Habilidade cobre muitas tarefas não relacionadas | A descrição se torna ampla e sem foco, prejudicando a correspondência | Divida em duas ou mais Habilidades de propósito único |
Um hábito útil é tratar a descrição como uma consulta de pesquisa que você está pré-escrevendo em nome de cada versão futura de si mesmo que possa solicitar essa tarefa com palavras ligeiramente diferentes.
Isso significa testar uma nova Habilidade com a formulação real que você espera usar no dia a dia, não uma mensagem de teste genérica, e revisar a descrição após observar um resultado real em vez de adivinhar antecipadamente.
É também por isso que problemas de descoberta e problemas de instruções são confundidos: uma Habilidade que nunca dispara e uma Habilidade que dispara, mas produz o resultado errado parecem semelhantes do lado de fora, mas a correção vive em uma parte diferente do arquivo em cada caso.
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.