Pular para o conteúdo

Como criar skills no Claude, do pedido ao arquivo pronto

Para criar uma skill no Claude você tem dois caminhos: pedir para o próprio Claude montar a skill numa conversa ou escrever o arquivo SKILL.md você mesmo. Nos dois casos o resultado é igual: uma pasta com um nome em minúsculas, uma descrição que diz quando a skill deve ser usada e as instruções do seu processo. Depois é instalar, ligar e testar numa conversa nova.

Antes de tudo, ligue o recurso de arquivos

Skills dependem da criação de arquivos. Nas configurações do Claude, na área de recursos (Capabilities), ligue a opção de criar e editar arquivos. Depois abra Customize > Skills (Personalizar > Habilidades) e confira se o botão de adicionar aparece.

Escolha uma tarefa pequena e frequente

Pegue algo que você pede quase todo dia e que tem um formato claro: mensagem de cobrança, resposta a pedido de orçamento, legenda de post, resumo de ligação com cliente. Separe três coisas antes de abrir o Claude:

  • Um resultado que você já aprovou e usaria de novo.
  • As regras que você vive repetindo para a IA.
  • As correções que você sempre faz na mão depois que a resposta chega.

Cada correção vira uma linha da skill.

Caminho 1: criar conversando com o Claude

É o mais simples para quem não quer mexer em arquivo. A Anthropic tem uma skill própria para isso, a skill-creator, que o Claude usa para montar a estrutura certa. Abra uma conversa nova e descreva o que você quer, colando o material que separou:

Quero criar uma skill para [tarefa, ex.: responder pedidos de orçamento de fotografia de eventos].

Quando eu uso: [ex.: quando colo a mensagem de um cliente pedindo preço ou data].

Regras que sempre repito:
- [regra 1]
- [regra 2]
- [regra 3]

Formato que eu quero: [tamanho, ordem das partes, assinatura].

Exemplo de resultado que aprovei:
[cole aqui]

O que nunca pode acontecer: [ex.: oferecer pacote que não existe].

O Claude costuma devolver perguntas sobre casos de uso e sobre o que torna um resultado bom. Responda com detalhe. No fim ele gera a skill e oferece a opção de salvar. Confira em Customize > Skills se ela apareceu e está ligada, e leia o que ele escreveu: se vier explicação demais sobre o óbvio, peça para cortar.

No Cowork do aplicativo para Mac (planos Pro, Max, Ultra e Team) há um terceiro jeito: gravar a tela fazendo a tarefa para o Claude propor a skill.

Caminho 2: escrever o SKILL.md na mão

Esse caminho dá controle total. Crie uma pasta com o nome da skill e, dentro dela, um arquivo de texto puro chamado SKILL.md. Bloco de Notas ou TextEdit em modo texto simples servem; Word não serve. Veja um exemplo completo para quem fotografa eventos:

---
name: orcamento-fotografia
description: Responde pedidos de orçamento de fotografia de eventos com pacotes e condições do estúdio. Usar quando o cliente pedir preço, pacote, data disponível ou orçamento.
---

# Orçamento de fotografia

## Pacotes
- [Pacote 1]: [horas de cobertura], [número de fotos editadas], R$ [valor]
- [Pacote 2]: [horas de cobertura], [número de fotos editadas], R$ [valor]

Reserva da data com [percentual]% de sinal.

## Como responder
1. Agradeça o contato pelo nome, em uma frase.
2. Se faltar data, local ou tipo de evento, pergunte antes de passar valor.
3. Indique o pacote que combina com o que o cliente descreveu e cite o outro como alternativa.
4. Termine propondo uma ligação de 15 minutos ou o envio do contrato.

## Nunca
- Inventar desconto ou pacote fora da lista.
- Confirmar a data sem avisar que ela depende do sinal.

Regras do cabeçalho que derrubam muita gente:

  • O --- de abertura precisa estar na primeira linha do arquivo, sem nada antes.
  • O name aceita só letras minúsculas, números e hífens, até 64 caracteres, sem acento e sem as palavras "claude" ou "anthropic". E precisa ser idêntico ao nome da pasta.
  • A description deve dizer o que a skill faz e quando usar. Mantenha curta: a central de ajuda indica até 200 caracteres para skills enviadas no claude.ai.

Com o arquivo pronto, compacte a pasta em ZIP e envie pelo botão de adicionar em Customize > Skills.

A descrição é o que faz a skill funcionar

O Claude compara o seu pedido com a descrição para decidir se abre a skill. Escreva em terceira pessoa ("Responde pedidos de..."), não como conversa ("Eu te ajudo a..."), e use as palavras do seu dia a dia. Se você costuma dizer "me ajuda a passar o valor pra esse cliente", inclua "valor" e "cliente" ali. Tem duas skills parecidas? Deixe claro na descrição o que separa uma da outra.

Teste antes de confiar

Abra uma conversa nova e peça a tarefa do jeito normal, sem citar a skill. Segundo o tutorial oficial da Anthropic, o raciocínio do Claude mostra algo como "Using [nome da skill]" quando ela é usada. Repita com outras formas de pedir e com um caso difícil, como uma mensagem sem a data do evento.

Se a skill não foi acionada, o problema está na descrição. Se foi acionada mas o resultado saiu torto, ajuste as instruções do corpo.

No ebook "Skills de IA" você encontra os três caminhos de criação em detalhe, seis skills completas para adaptar (atendimento, Instagram, relatório semanal, contratos simples, planilhas e proposta comercial), uma tabela de diagnóstico para quando a skill falha e a lista de erros mais comuns.