Você já percebeu que explica a mesma tarefa à IA toda semana. O formato, as regras, o «não esquece de…». A saída é transformar essa explicação numa skill: um procedimento escrito que o Claude lê quando a tarefa aparece. Este guia mostra cada parte do arquivo, o que escrever nela e por quê. No fim, você tem uma skill inteira de exemplo para adaptar à sua tarefa.
Veio do Reel? A palavra era CRIAR.
O que você vai montar
Uma pasta com um arquivo principal, o SKILL.md, e, se precisar, um arquivo de apoio. O SKILL.md tem seis partes:
- Nome: curto, sem espaço.
- Descrição: quando usar. É ela que faz o Claude achar a skill.
- Passos: o que fazer, na ordem.
- Modelo da entrega: o formato exato do resultado.
- Nunca faça: o que é proibido, sem exceção.
- Arquivo de apoio (opcional): a tabela, a lista ou o texto de referência que a skill consulta.
Se você quer o caminho mais rápido, em que a IA entrevista você e escreve a primeira versão, veja Três jeitos de criar uma skill. Aqui o foco é entender cada parte, para você conseguir ajustar qualquer skill depois.
Passo 1: escolha uma tarefa que mereça
Boa tarefa para skill tem três traços: se repete, tem formato conhecido e é barata de errar no começo.
Na Distribuidora Modelo (empresa fictícia que usamos nos exemplos: distribuidora de produtos de limpeza para mercados, padarias e restaurantes da Grande São Paulo e de Campinas), o Rafael, da Logística, escolheu o aviso de rota. Toda semana ele escreve aos clientes de uma rota avisando o dia e a janela de entrega. O texto é sempre parecido, e as regras são sempre as mesmas.
Passo 2: nome e descrição
O arquivo começa com um cabeçalho de duas linhas entre traços:
---
name: aviso-de-rota
description: Use quando pedirem o aviso de rota, a mensagem para os clientes de uma rota de entrega, ou "avisa os clientes de quinta". Gera um rascunho por cliente a partir da lista da rota. Não envia nada.
---
O nome é a identidade da skill. Letras minúsculas e hífen.
A descrição é a parte mais importante do arquivo inteiro. O Claude lê a descrição de todas as skills instaladas e escolhe a que serve para o pedido. Por isso:
- Diga quando usar, com as palavras que alguém usaria ao pedir.
- Diga o que entrega, em uma frase.
- Diga o limite, se houver: «não envia nada».
Descrição vaga, como «ajuda com logística», faz a skill nunca ser encontrada, ou ser encontrada na hora errada.
Passo 3: os passos, na ordem
Depois do cabeçalho, escreva o procedimento como você explicaria a um colega no primeiro dia:
## Passos
1. Peça a lista da rota se ela não veio no pedido: cliente, dia, janela
de horário. Não comece sem a lista.
2. Confira se cada cliente tem dia e janela. Se faltar, marque FALTA
e não escreva a mensagem desse cliente.
3. Escreva uma mensagem por cliente, seguindo o modelo abaixo.
4. No fim, liste o que o Rafael precisa conferir antes de enviar.
Passos numerados, um verbo por passo. Se um passo tem «e depois», provavelmente são dois.
Passo 4: o modelo da entrega
Mostre o formato exato. Não descreva, mostre:
## Modelo da entrega
Para cada cliente:
CLIENTE: [nome]
Oi! Aqui é o Rafael, da Distribuidora Modelo.
A entrega de vocês sai na [dia], entre [janela].
Se precisar mudar, responda esta mensagem até [dia anterior], 16h.
Depois de todos:
CONFERIR ANTES DE ENVIAR
- [o que faltou ou parece estranho]
Um exemplo preenchido vale mais que três parágrafos de explicação. Se você tem uma mensagem real boa, sem dado pessoal, cole como exemplo logo abaixo.
Passo 5: o «nunca faça»
Esta seção é curta e dura. Nada de «cuidado com» ou «evite». Regra clara:
## Nunca faça
- Não envie mensagem a ninguém. Entregue o rascunho e pare.
- Não prometa horário fora da janela que está na lista.
- Não invente dia ou janela. Se faltar, escreva FALTA.
- Não inclua telefone, endereço ou nome do contato do cliente.
Toda skill que gera algo que sai da empresa termina num rascunho e para. Quem envia é uma pessoa. Na Distribuidora, é o próprio Rafael.
Passo 6: o arquivo de apoio, se precisar
Algumas skills precisam consultar algo que muda: uma tabela de preços, a lista de rotas, as regras de frete. Em vez de escrever isso dentro do SKILL.md, ponha num arquivo separado na mesma pasta e cite no passo:
aviso-de-rota/
SKILL.md
rotas.md ← dias e janelas de cada rota
E no passo 1: «Se o pedido não trouxer a janela, consulte rotas.md.» Quando a rota de quinta para Campinas passou a sair às 6h, o Rafael mudou uma linha no rotas.md, e a skill não precisou ser reescrita.
Passo 7: instale e teste
O caminho depende de onde você usa o Claude:
- No app: compacte a pasta e envie na área de skills das configurações, se o seu plano oferecer. Confira na documentação do seu plano.
- No Claude Code: salve a pasta dentro da pasta de skills do seu usuário, ou na do projeto, para o time usar junto.
Depois, abra uma conversa nova e peça do jeito natural, sem falar em skill: «faz o aviso para os clientes de quinta». Olhe três coisas:
- A skill foi usada? Se não, a descrição precisa das palavras que você usou no pedido.
- Veio no formato? Se não, ponha um exemplo preenchido no modelo.
- Respeitou o «nunca faça»? Se escorregou, deixe a regra mais concreta.
Cada correção é uma linha. Em duas ou três rodadas a skill fica do seu jeito.
Passo 8: dê um dono
Skill de empresa precisa de uma pessoa responsável. Ela aprova mudanças e decide quando a skill está velha. A do aviso de rota é do Rafael. Sem dono, aparecem cópias diferentes da mesma skill e ninguém sabe qual vale.
O que a IA não faz aqui
- Não sabe a regra que você não escreveu. Se está só na sua cabeça, a skill não segue.
- Não envia. A skill para no rascunho, por regra.
- Não se atualiza sozinha. Mudou a regra da empresa, alguém muda o arquivo.
O fecho
A primeira skill feita parte por parte leva mais tempo do que pedir à IA para escrever. Em troca, você entende o que cada linha faz e consegue consertar qualquer skill depois. Para ver onde a skill se encaixa ao lado de prompt, agente e rotina, leia Prompt, skill e agente. E, para saber quais vale ter primeiro, veja Skills essenciais.