Como criar uma skill no Claude: guia do SKILL.md (2026)

Uma skill do Claude é uma pasta com um único arquivo obrigatório, o SKILL.md: um cabeçalho curto que diz o que a skill faz e quando usá-la, seguido de instruções em linguagem comum. Veja como criar uma skill no Claude Code: crie uma pasta dentro de ~/.claude/skills/, escreva um SKILL.md com name e description, depois peça a tarefa com as suas palavras ou digite / seguido do nome da skill. Abaixo você vai montar uma skill funcional para quem trabalha com marketing, entender como o Claude decide quando carregá-la e instalar skills feitas por outras pessoas.

O que é uma skill do Claude, em palavras simples

Pense em uma skill como um procedimento salvo que o Claude tira da prateleira quando o trabalho pede. Em vez de colar as mesmas instruções em toda conversa, você escreve uma vez em um arquivo, e o Claude só abre esse arquivo quando o seu pedido combina.

As skills usam o formato aberto Agent Skills, que a Anthropic criou e lançou como padrão. Uma pasta de skill é portátil: Claude Code, os apps do Claude e a API do Claude aceitam o mesmo formato, e este guia foca no Claude Code, onde skills são arquivos comuns.

Quem já usa o Claude Code precisa saber que os comandos de barra personalizados foram incorporados às skills. Um arquivo antigo .claude/commands/review.md continua funcionando, mas uma pasta de skill também pode guardar modelos, exemplos e scripts.

Sobre o primeiro e o terceiro 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: a descrição é o gatilho. Se ela não tiver as palavras que você usa naturalmente para pedir a tarefa, o Claude não vai buscar a skill.

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 skills ficam

O sinal ~ significa a sua pasta pessoal: /Users/seunome no Mac e C:\Users\seunome no Windows. Se uma skill pessoal e uma de projeto tiverem o mesmo nome, a pessoal vence.

Monte uma skill de brief de campanha, passo a passo

O exemplo é uma skill para quem trabalha com marketing e escreve um brief de campanha 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:

Create a personal skill folder called campaign-brief in my skills directory (~/.claude/skills/) with an empty SKILL.md file inside it.

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 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. Mantive o texto em inglês porque é assim que o Claude Code recebe a maioria das skills, 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.

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.

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.

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.

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.
• 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 esquece uma regra no fim de uma sessão longa: leve essa regra para o topo. Quando uma conversa longa é compactada, o Claude Code mantém só o começo de cada skill que anexa de novo.

Configurações opcionais que vale conhecer

Ignore isto até a sua primeira skill funcionar.

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

Use a mesma skill no app do Claude

As skills também funcionam nos apps web e desktop do Claude, 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.

A Central de Ajuda indica um limite de 200 caracteres para a descrição no claude.ai, mais um motivo para mantê-la enxuta. O exemplo acima cabe.

Instale skills feitas por outras pessoas

Você não precisa escrever todas as skills:

O repositório público de skills da Anthropic (veja as testadas no nosso diretório de 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.

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 usar skills apenas de fontes confiáveis, ou seja, as que você escreveu ou recebeu da Anthropic, e auditar com cuidado todo o resto.

Solução de problemas

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, e o diretório de Claude Skills mostra o que outras pessoas criaram. 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.