Claude Skills: o que são e como criar a sua com SKILL.md

O que são Claude skills?

Claude skills são pastas de instruções, com um arquivo SKILL.md e, se você quiser, exemplos e scripts, que o Claude carrega sozinho quando o seu pedido combina com a descrição da skill. Você escreve um procedimento uma vez, em vez de colá-lo em toda conversa, e um comando de barra personalizado antigo, como .claude/commands/review.md, continua funcionando, porque os comandos de barra agora também são skills.

As skills usam o formato aberto Agent Skills, então a mesma pasta funciona no Claude Code, nos apps do Claude e na API do Claude. Para ver skills prontas para instalar, consulte o nosso diretório de skills do Claude Code. As skills são a aula 3 do nosso curso Claude grátis, que também cobre Projects, conectores e tarefas.

Claude skills vs MCP, plugins e CLAUDE.md

A Central de Ajuda da Anthropic resume a diferença entre skills e MCP de forma simples: o MCP dá ao Claude acesso a uma ferramenta, e a skill ensina o Claude a usá-la bem, então os dois funcionam melhor juntos. Para os outros cartões, veja o que colocar em um arquivo CLAUDE.md e o que é um servidor MCP.

Como as skills carregam, e por que a descrição é o mais importante

A visão geral de Agent Skills da Anthropic descreve um carregamento em três níveis que ela chama de progressive disclosure (revelação progressiva). Um token, nesses números, é o pedacinho de texto que os modelos de IA contam, muitas vezes uma palavra curta ou parte de uma palavra maior.

Primeira lição: o Claude decide se abre uma skill só pelo nome e pela descrição. Quando várias skills ou ferramentas podem fazer um trabalho, ganha aquela cuja descrição usa as suas palavras.

Segunda lição: cada skill instalada custa um pouco de atenção em todo turno, então poucas skills bem usadas valem mais que uma lista longa de que você nem lembra.

Onde as Claude skills ficam guardadas

O sinal ~ significa a sua pasta pessoal: /Users/yourname no Mac e C:\Users\yourname no Windows, então uma skill pessoal no Windows fica em C:\Users\yourname\.claude\skills\. A pasta .claude fica oculta por padrão: aperte Cmd + Shift + . no Finder, ou ative Hidden items em View no Explorador de Arquivos. Se uma skill pessoal e uma de projeto tiverem o mesmo nome, a pessoal vence.

Como criar uma skill no Claude, passo a passo

O exemplo é uma das Claude skills para marketing mais simples de montar: um redator de briefs de campanha para quem trabalha com marketing e produz um toda semana. Ela coleta primeiro o que falta, escreve o brief numa estrutura fixa e confere o próprio trabalho antes de entregar.

Passo 1: Anote o procedimento que você já segue

Passo 2: Crie a pasta da skill

O caminho mais fácil é pedir ao Claude Code:

Crie uma pasta de skill pessoal chamada campaign-brief no meu diretório de skills (~/.claude/skills/), com um arquivo SKILL.md vazio dentro dela.

Se preferir digitar você mesmo, use o Terminal no Mac:

$ mkdir -p ~/.claude/skills/campaign-brief
$ 

Ou o PowerShell no Windows:

PS> New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\campaign-brief"
PS> 

Passo 3: Escreva o arquivo SKILL.md

Crie o SKILL.md dentro da pasta e cole o conteúdo abaixo. A parte entre as duas linhas --- é o frontmatter, um pequeno bloco de configurações escrito em YAML (um formato simples de "chave: valor"), e tudo depois dele são as instruções. Mantivemos o arquivo como foi testado, em inglês, mas você pode escrever as instruções em português, e de preferência a descrição com as palavras em português que você vai digitar.

---
name: campaign-brief
description: Writes a one-page marketing campaign brief from rough notes. Use when the user asks for a campaign brief, a creative brief, or a plan for a launch, promotion or email campaign.
---

# Campaign brief

## Before writing
Check that you have these inputs. Ask for anything missing in one short list, then wait:
- Product or offer, and its price if there is one
- Audience: who they are and the problem they have
- Goal: one measurable result, such as demo bookings or first purchases
- Channels and deadline
- Budget, or "none"

## Write the brief
Use exactly these sections, in this order:
1. Summary (three sentences at most)
2. Audience and their main objection
3. Key message and three supporting points
4. Offer and call to action
5. Channels, with one line on the job of each
6. Timeline with dates
7. How we will measure success
8. Open questions

If brand/voice.md exists in this project, read it first and follow it.
Save the brief as briefs/YYYY-MM-DD-campaign-name.md.

## Rules
- Never invent numbers, prices, dates or testimonials. Write [TBD] instead.
- Keep it to one page, about 450 words.
- Use the words the audience would use, not marketing jargon.

## Before you finish
Re-read the brief and confirm that every section is filled or marked [TBD], the goal can be measured, and the call to action matches the offer. List every [TBD] at the end.

O Claude Code em si só precisa da description; sem um name, o nome da pasta vira o comando. O app do Claude exige os dois, então escreva os dois e um único arquivo funciona em todo lugar.

Passo 4: Adicione um arquivo de apoio

Cole um brief de que você se orgulha em examples.md na mesma pasta e adicione uma linha em "Write the brief": "For tone and depth, see examples.md." O Claude só lê o exemplo quando roda a skill, então ele não custa nada no resto do tempo. A Anthropic sugere manter o SKILL.md com menos de 500 linhas e levar material de referência longo para arquivos como este.

campaign-brief/
  SKILL.md
  examples.md

Passo 5: Teste de dois jeitos

Abra o Claude Code em qualquer pasta de projeto. Se ele já estava aberto e a pasta de skills é nova, rode /reload-skills primeiro.

Primeiro, o teste automático: peça com palavras comuns e veja o Claude pegar a skill.

Rodamos exatamente isso numa pasta de projeto com a skill acima. A primeira linha da resposta do Claude mostra a skill carregando e, como a skill manda, ele pediu as informações que faltavam antes de escrever qualquer coisa (essa tela é a imagem no topo deste guia). Respondemos com a oferta, o objetivo e a data de envio, e ele salvou o brief e listou o que ainda estava em aberto:

Depois, o teste direto: digite /campaign-brief e-mail da liquidação de fim de ano, e o texto depois do nome da skill é passado como argumento. Para confirmar que o Claude enxerga a skill, pergunte "Quais skills estão disponíveis?" ou rode /skills.

O que aconteceu nos nossos 18 testes de acionamento

Rodamos exatamente esta skill no Claude Code 2.1.303 com o Opus 5.5 em outubro de 2026, cada pedido numa sessão nova, ao lado de cerca de 90 outras skills instaladas, incluindo uma skill de brief de conteúdo para SEO. Os pedidos foram feitos em inglês; aqui eles aparecem traduzidos:

Todo acerto pediu a oferta, o objetivo e as datas que faltavam em vez de inventá-los: é a seção "Before writing" funcionando.

Depois cortamos a descrição para "Marketing document helper." e, mais tarde, também renomeamos a skill para mkt-helper. As duas versões ainda carregaram nos quatro pedidos de brief e de plano e ignoraram um pedido de legenda e um de e-mail de agradecimento. Numa das execuções, porém, o Claude primeiro recorreu a uma ferramenta de documentos conectada.

Passo 6: Ajuste

Conte com algumas rodadas de edição. O Claude Code percebe mudanças nos arquivos de uma skill durante a sessão, então edite, salve e tente de novo.

• Ela nunca é acionada: adicione à descrição as palavras que você realmente usa e confira se a descrição de outra skill reivindica o mesmo trabalho.
• Ela é acionada quando você não quer: restrinja a descrição ou adicione disable-model-invocation: true para que a skill só rode quando você digitar o comando.
• Ela faz dois trabalhos mal: divida em uma skill por trabalho, cada uma com a própria descrição.
• Ela esquece uma regra no fim de uma sessão longa: leve essa regra para o topo. Quando uma conversa longa é compactada, o Claude Code anexa de novo só os primeiros 5.000 tokens de cada skill.

Quer ajuda com o ajuste? O plugin Skill Creator da Anthropic se instala com /plugin install skill-creator@claude-plugins-official. Peça para ele avaliar a sua skill, e ele roda prompts de teste com e sem a skill e depois sugere mudanças na descrição.

Configurações opcionais do frontmatter do SKILL.md

Ignore isto até a sua primeira skill funcionar.

Dentro das instruções, $ARGUMENTS marca onde entra o texto que você digita depois do comando.

Como fazer uma skill no Claude sem escrever o arquivo

Você não precisa digitar o SKILL.md você mesmo. O Claude consegue rascunhá-lo em três lugares:

Transforme o que acabamos de fazer numa skill chamada [NOME-DA-SKILL]. Mantenha os passos que funcionaram, acrescente como regra cada correção que eu te dei e escreva uma descrição com menos de 200 caracteres que liste as expressões que eu usaria para pedir isso. Me mostre o SKILL.md antes de salvar.

Fazer a tarefa primeiro importa: as correções que você faz pelo caminho viram as regras da skill. Leia o rascunho antes de ativá-la.

Como subir uma skill no Claude (app web e desktop)

As skills também funcionam nos apps web e desktop do Claude, nos planos Free, Pro, Max, Team e Enterprise, com a configuração descrita no artigo de ajuda da Anthropic sobre skills:

1. Ative a execução de código. Nos planos Free, Pro e Max, abra Settings > Capabilities e ative Code execution and file creation. Nos planos Team e Enterprise, um proprietário ativa para a organização.
2. Compacte a pasta. A própria pasta precisa ficar no topo do arquivo zip: campaign-brief.zip contém campaign-brief/SKILL.md.
3. Faça o upload. Abra Customize > Skills, clique em +, escolha Create skill e depois Upload a skill.
4. Ative e teste. Experimente alguns prompts que deveriam acionar a skill.

No Mac, um zip com a estrutura certa sai de clicar com o botão direito na própria pasta campaign-brief e escolher Compress. No Windows, clique com o botão direito na pasta e escolha Compress to ZIP file (Windows 11) ou Send to > Compressed (zipped) folder (Windows 10). Compactar os arquivos de dentro da pasta, em vez da pasta, é o motivo mais comum de um upload falhar.

Instale Claude skills do GitHub e de plugins

O repositório público de skills da Anthropic no GitHub, uma boa fonte de exemplos de Claude skills, também funciona como marketplace. Estes dois comandos o adicionam e instalam as skills de exemplo, que incluem diretrizes de marca, coautoria de documentos e skills de design como a Canvas Design:

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

Em seguida o Claude Code pergunta o escopo: só você, todos neste projeto, ou só você neste projeto. No app do Claude, você ativa as mesmas skills de exemplo em Customize > Skills.

Confira uma skill antes de confiar nela

Uma skill pode mandar o Claude rodar comandos e ler arquivos, então trate a instalação como a de qualquer software. A documentação da Anthropic recomenda auditar toda skill que você não escreveu nem recebeu da Anthropic.

Claude skills não funcionam? Problemas comuns e soluções

O que fazer agora

Escolha uma tarefa que você explicou ao Claude mais de duas vezes neste mês e transforme em skill hoje, usando o brief de campanha como modelo. Teste com três formas diferentes de pedir antes de confiar nela.

Para ideias que valem a pena empacotar, os fluxos de Claude Code para profissionais de marketing viram boas skills. Se quiser uma configuração guiada de skills, MCP e CLAUDE.md juntos, o curso de Claude Code cobre os três no módulo de configuração.