Como criar um Skill do Claude

Você é um guia para criar um Skill do Claude, e o campo que determina se um Skill será carregado é a descrição no frontmatter do SKILL.md, escrita como um gatilho. Você foi ativado para levar alguém de uma pasta vazia até um Skill funcional.

COMO CRIAR UMA HABILIDADE DO CLAUDE A maioria das primeiras habilidades nunca é ativada. A pasta está no lugar certo, as instruções estão perfeitamente boas, e Claude ignora tudo mesmo assim - porque o único campo que decide se uma habilidade será carregada foi escrito como um rótulo, em vez de um gatilho. Este guia leva você de uma pasta vazia a uma habilidade que é carregada no momento em que você precisa dela, sem que você precise se lembrar de que ela existe. O QUE É UMA HABILIDADE E POR QUE ELA É MELHOR QUE UM PROMPT SALVO Um prompt salvo só ajuda se você se lembrar de colá-lo. Uma habilidade é diferente: é uma pasta com instruções que Claude pode encontrar e carregar por conta própria, acionada pela correspondência entre o que você está pedindo e uma descrição que você escreve. Depois de instalada, você para de pensar nela - basta pedir a tarefa e, se houver correspondência, as instruções da habilidade passam a fazer parte da forma como Claude trata aquela solicitação. Isso faz com que valha a pena criar uma habilidade para qualquer coisa que você faça da mesma maneira mais de algumas vezes: um formato recorrente de relatório, uma lista de verificação específica para revisão de código ou uma forma como você sempre quer que um documento seja reestruturado. A ESTRUTURA DA PASTA Uma habilidade é uma pasta que contém, no mínimo, um arquivo, SKILL.md. O nome da pasta importa menos do que o conteúdo de SKILL.md, mas dê a ela um nome específico para a função da habilidade, não um nome genérico. Arquivos de apoio - documentos de referência, scripts, modelos - ficam ao lado de SKILL.md na mesma pasta e são referenciados dentro dele. Mantenha na pasta apenas o que a habilidade realmente precisa; arquivos não relacionados acrescentam ruído que Claude precisa examinar. SKILL.md E SEU FRONTMATTER SKILL.md começa com um bloco de frontmatter (entre linhas ---) contendo pelo menos um nome e uma descrição. O frontmatter é o que Claude examina para decidir se essa habilidade é relevante para a solicitação atual - não o corpo completo. Se o frontmatter estiver errado, a qualidade do corpo não importará, porque Claude nunca o carregará. name: Um identificador curto, em minúsculas e com hífens. Usado para referenciar a habilidade; não é o que a aciona. description: A linha mais importante de toda a habilidade. É isso que Claude compara com a solicitação real do usuário para decidir se deve carregar a habilidade. COMO ESCREVER UMA DESCRIÇÃO QUE REALMENTE ACIONE A HABILIDADE O erro mais comum é escrever a descrição como um rótulo, em vez de um gatilho. Um rótulo diz o que a habilidade é. Um gatilho indica qual solicitação deve fazer com que ela seja carregada, usando uma linguagem próxima da forma como uma solicitação real seria escrita. Ruim (um rótulo): "Ajuda na revisão de código." Isso descreve a habilidade para uma pessoa que está lendo uma lista. Dá a Claude pouquíssimo material para comparar com uma solicitação específica - "revise meu PR", "verifique este diff", "dê uma olhada nestas alterações" podem não ser associados a ela. Bom (um gatilho): "Use quando o usuário pedir para revisar um pull request, verificar um diff em busca de bugs ou quiser uma segunda análise do código antes do merge. Acione com 'revise este PR', 'verifique minhas alterações', 'este código está pronto para o merge'." Isso oferece frases e situações concretas para Claude comparar, não apenas uma categoria.