Claude Skills: o que são e como criar uma skill
O que é uma skill do Claude, onde ela roda e como escrever e testar a primeira skill do seu time de marketing, com base na documentação oficial.

Uma skill do Claude é uma pasta com um arquivo chamado SKILL.md que ensina ao Claude como o seu time faz uma tarefa. O Claude lê só o nome e a descrição de cada skill e carrega o resto quando o pedido combina com ela. Você escreve o processo uma vez e ele sai igual para qualquer pessoa do time.
No Studio, o Claude escreve copy, audita página e roda o radar de tendências. Nada disso funciona com prompt solto. Funciona porque cada processo virou uma skill. Neste artigo eu mostro o que é uma skill, quando vale criar uma e como escrever a primeira.
O que é uma skill do Claude e o que muda em relação a um prompt
Quem usa o Claude no marketing conhece a cena: cada pessoa escreve o mesmo pedido de um jeito, recebe uma resposta diferente e passa meia hora ajustando o tom. O problema não é o modelo. É que o processo mora na cabeça de quem pede.

A skill tira o processo da cabeça e põe num arquivo. A documentação da Anthropic chama o recurso de Agent Skills. A diferença para um prompt salvo é que a skill carrega sozinha quando é útil, sem ninguém colar nada.
Quando vale criar uma skill
Um processo merece virar skill quando passa nos três sinais:
- Você repete. O mesmo pedido aparece toda semana, com o mesmo contexto colado de novo.
- Tem regra. Existe um jeito certo, com etapas, palavras proibidas e erros conhecidos.
- Mais gente faz. O resultado muda conforme quem pede, e o cliente percebe.
Não vale para tarefa que acontece uma vez, para pedido que muda sempre nem para decisão que depende de conversa com o cliente. Nesses casos, um bom pedido na hora resolve melhor.
Para começar, liste os 5 pedidos que o time mais repetiu no mês. Os que passam nos três sinais são os candidatos à primeira skill.
Como uma skill funciona por dentro
Uma skill é uma pasta. Dentro dela fica o SKILL.md, com duas partes: o cabeçalho, que diz o que a skill faz e quando usar, e o corpo, com as instruções. Arquivos de apoio e scripts são opcionais.
O Claude lê a skill em três camadas, segundo a visão geral das Agent Skills (lida em 19/11/2026):

| Camada | Quando entra | Quanto ocupa |
|---|---|---|
| Nome e descrição | Sempre, desde o início da conversa | Cerca de 100 tokens por skill |
| Corpo do SKILL.md | Quando o pedido combina com a descrição | A referência é ficar abaixo de 5 mil tokens |
| Arquivos de apoio e scripts | Só quando citados | Do script, só a saída entra na conversa |
É por isso que dá para ter dezenas de skills instaladas sem pesar: até disparar, cada uma ocupa só a linha da descrição.
Onde a skill roda
A mesma pasta funciona em três lugares, com pequenas diferenças (documentação lida em 19/11/2026):
| Onde | Como instalar | Observação |
|---|---|---|
| claude.ai | Envio da pasta em .zip nas configurações | Planos Pro, Max, Ultra, Team e Enterprise, com execução de código ligada |
| Claude Code | Pasta em ~/.claude/skills (sua) ou .claude/skills (do projeto) | O Claude encontra sozinho |
| API | Envio pela Skills API (/v1/skills) | Roda num contêiner sem acesso à internet |
Como criar uma skill no Claude em 5 passos
1. Teste antes de escrever. A recomendação das boas práticas da Anthropic inverte a ordem comum: primeiro você vê onde o Claude erra sem a skill, depois escreve só o que corrige esses erros. Rode pedidos reais e anote as falhas.
2. Escreva o cabeçalho. Ele tem duas regras:
name: até 64 caracteres, só letras minúsculas, números e hífen, sem as palavras "anthropic" e "claude".description: obrigatória, até 1.024 caracteres, sem tags XML, dizendo o que a skill faz e quando usar.
3. Capriche na descrição. É a linha que o Claude compara com o pedido para decidir se usa a skill. Compare:
- Fraca: "Ajuda com textos de marketing." Dispara em tudo ou em nada.
- Forte: "Escreve e revisa copy de conversão para landing pages, anúncios e e-mails. Use quando pedirem headline, CTA, página de venda ou revisão de copy."
A forte diz a tarefa, o formato e as palavras que aparecem no pedido do time. E está em terceira pessoa, como pede a documentação.
4. Escreva o corpo como roteiro. O Claude já sabe escrever; a skill diz como o seu time faz. Um bom corpo tem entrada (o que pedir antes de começar), passos, regras da marca, formato de saída e um exemplo aprovado. Corte o que o Claude já sabe e use sempre o mesmo termo do começo ao fim.
5. Compare com e sem a skill. Rode o mesmo pedido duas vezes, cada vez numa conversa nova, e compare tom, regras, formato e minutos de ajuste. Repita com 3 pedidos diferentes antes de concluir. Um teste só não diz nada.
Uma dica que uso no Studio: escreva a skill numa conversa e teste em outra, nova. Quem escreveu já conhece o contexto e não serve de teste.
Cuidado com skill de terceiros
Uma skill traz instruções e, às vezes, código. A documentação recomenda usar só skills que você escreveu ou de fonte confiável, e ler todos os arquivos antes de instalar. Vale também para as listas de skills prontas que circulam no GitHub.
Perguntas frequentes
Skill do Claude é o mesmo que Agent Skills?
Sim. Agent Skills é o nome do recurso na documentação da Anthropic. No dia a dia, as pessoas chamam de skills do Claude ou Claude Skills.
Preciso saber programar para criar uma skill?
Não. O SKILL.md é um arquivo de texto com um cabeçalho e instruções em português. Script é opcional e entra quando uma conferência não pode falhar, como contar caracteres de anúncio.
Qual o tamanho ideal de uma skill?
As boas práticas da Anthropic recomendam manter o corpo do SKILL.md abaixo de 500 linhas. Quando passa disso, o detalhe vai para arquivos de apoio citados no próprio SKILL.md.
Skill funciona no plano gratuito do claude.ai?
Na documentação lida em 19/11/2026, as skills no claude.ai aparecem para os planos Pro, Max, Ultra, Team e Enterprise, com a execução de código ligada. Confira a página oficial, porque os planos mudam.
Para ir além: o e-book Skills de marketing para o Claude
Este artigo é o começo. O e-book tem o método inteiro, em 25 páginas e 5 capítulos:
- a descrição que faz o Claude usar a skill na hora certa;
- o roteiro de teste com e sem skill e a ficha de comparação;
- 5 skills que o Studio usa na operação, abertas por dentro;
- como versionar e manter as skills no time;
- um modelo de SKILL.md em branco para copiar.
Todas as regras vêm da documentação oficial, com link em cada página.
Prefere que eu monte as skills do processo do seu time? Conheça o serviço de Criação com IA.
Leia também: Claude Code: o que é e como usar sem programar e MCP no Claude: o que é e como usar os conectores.