Skills do Claude Code: o que são, como instalar e como criar a sua

Se você buscou "skills claude code" no Google em português, provavelmente caiu numa página em inglês. A documentação oficial, as listas de "10 melhores", os repositórios no GitHub: quase tudo está em inglês e quase tudo foi escrito por programador. Este guia existe para preencher esse buraco. Ele explica o que são as skills do Claude Code, como funcionam por dentro, como colocar uma para rodar, como criar a sua, e o que muda quando você usa isso para marketing em vez de código.

Se você ainda não tem o Claude Code, comece por como instalar o Claude Code sem terminal e volte aqui.

O que são as skills do Claude Code

É uma pasta com um arquivo chamado SKILL.md dentro. Esse arquivo carrega conhecimento procedural: como fazer um trabalho específico, na ordem certa, com os critérios certos. Quando você pede algo que ela sabe fazer, o Claude lê aquele arquivo e passa a trabalhar do jeito que está escrito ali.

A definição mais curta que eu conheço: é um processo empacotado para a IA executar. Não é um prompt salvo. Prompt é uma pergunta. Isto é um método, com começo, meio, fim e o que conferir em cada etapa.

Por dentro, o SKILL.md tem duas partes:

• O cabeçalho, em YAML, com o nome e uma descrição de quando ela deve ser usada. Essa descrição é a parte mais importante do arquivo inteiro, porque é por ela que o Claude decide se aquele processo serve para o que você pediu.
• O corpo, em Markdown, com as instruções: os passos, as regras, os exemplos, o formato da entrega.

A pasta pode ter mais coisa além do SKILL.md: uma subpasta scripts com programas que o processo roda, uma references com material de consulta, uma assets com modelos de arquivo. O SKILL.md é o índice; o resto é o que ele aponta.

Claude Skills e Agent Skills são a mesma coisa?

Sim, na prática. Agent Skills é o nome do padrão aberto (o Agent Skills open standard) que a Anthropic publicou para esse formato, para que o mesmo pacote funcione no Claude Code, no aplicativo do Claude, na Claude API (a Skills API) e em outros agentes que adotarem o padrão. "Claude Skills" e "Claude Code skills" são o mesmo formato, visto de dentro do produto. Se você criar uma hoje seguindo o padrão, ela é portátil.

Como as skills funcionam

O mecanismo tem três momentos, e entender isso evita a maioria das frustrações.

1. No início da conversa, o Claude Code carrega só o cabeçalho de cada uma das instaladas: nome e descrição. É pouco texto, então você pode ter dezenas sem pesar o contexto.

2. Quando você pede algo, ele compara o pedido com as descrições. Se uma bate, ele carrega o corpo daquele arquivo e passa a seguir as instruções. É por isso que a descrição precisa ser precisa: uma descrição vaga faz o processo disparar na hora errada ou não disparar nunca. Você também pode chamar diretamente pelo nome, digitando barra e o nome.

3. Enquanto trabalha, ele abre o que o arquivo aponta, só quando precisa: um script para rodar, uma referência para consultar, um modelo para preencher. Nada é carregado antes da hora.

O nome disso é revelação progressiva, e é o que permite que o processo seja profundo sem ser pesado. A auditoria de SEO que eu uso tem um SKILL.md curto e uma pasta references com os critérios detalhados de cada item. O Claude só abre os critérios quando chega no item.

Skill, MCP, CLAUDE.md, plugin: qual é a diferença

Essas quatro peças respondem à mesma pergunta, "como faço o Claude Code se comportar do meu jeito?", e é fácil confundir. A separação:

CLAUDE.md é o contexto permanente da pasta. Ele é lido em toda conversa, sempre. Serve para o que vale o tempo todo: quem você é, o que a pasta é, regras gerais de trabalho. Não serve para procedimento longo, porque tudo que está ali ocupa espaço em toda conversa, inclusive nas que não têm nada a ver.

Skill é procedimento sob demanda. Só entra quando o pedido combina com ela. É o lugar certo para "como fazer uma auditoria", "como montar uma campanha", "como escrever o relatório mensal".

MCP (Model Context Protocol) não é conhecimento, é conexão. Um servidor MCP dá ao Claude acesso a uma ferramenta externa: um navegador, uma planilha, uma API, um banco de dados. O processo diz o que fazer; a conexão dá com o que fazer. Um pode usar o outro no meio do trabalho.

Plugin é o pacote de distribuição. Um plugin pode reunir várias skills, servidores MCP, subagentes e comandos, e ser instalado de uma vez a partir de um marketplace. Se você quer entregar um conjunto para outras pessoas, plugin é o formato. Skills and plugins, como a documentação chama, andam juntos.

A pergunta que aparece toda hora, "qual é a diferença entre uma Agent Skill e um servidor MCP", tem uma resposta de uma linha: método de um lado, acesso do outro. Você pode ter os dois na mesma tarefa, e nas melhores é isso que acontece.

Onde encontrar skills prontas

Três lugares, do mais confiável para o mais amplo:

O repositório oficial da Anthropic no GitHub, anthropics/skills, com pacotes para trabalhar com documentos (Word, PowerPoint, Excel, PDF), entre outros. São o exemplo canônico de como um SKILL.md bem feito se parece, e vale abrir um deles só para aprender o formato.

Diretórios e listas da comunidade, como o awesome-claude-skills no GitHub e diretórios de Agent Skills. São centenas, de qualidade muito variada. A regra que eu uso: abro o SKILL.md, e se ele parece um prompt genérico esticado, fecho. Um bom tem passos, critérios e um formato de entrega definido.

Bibliotecas por área, feitas por quem conhece o trabalho. É o que o Marketing Pronto é para marketing: auditoria de SEO, campanha de vendas no Meta, relatório de campanha, calendário editorial, perfil do negócio, tudo em português, tudo terminando num entregável com a marca de quem rodou.

Uma observação sobre as listas de "10 melhores skills do Claude Code" que dominam a busca: quase todas são para programador. Se você trabalha com marketing, a melhor não é a mais popular, é a que resolve o trabalho que você refaz todo mês.

Como instalar uma skill no Claude Code

Elas vivem em pastas específicas, e o Claude Code procura nelas sozinho.

• Do projeto: dentro da pasta de trabalho, em .claude/skills/nome/SKILL.md. Valem só para aquela pasta e viajam com ela, o que é ótimo para compartilhar com equipe.
• Pessoais: na sua pasta de usuário, em ~/.claude/skills/nome/SKILL.md. Valem para qualquer projeto que você abrir.

Para colocar uma que você baixou, o gesto é sempre o mesmo, e vale decorar porque se repete para toda skill nova:

1. Baixe e descompacte. Você fica com uma pasta com o nome dela.
2. Arraste a pasta para dentro de .claude/skills/ do seu workspace (ou da sua pasta de usuário, se quiser que valha em todo lugar). No VS Code, dá para arrastar direto para a barra lateral.
3. Comece uma conversa nova. As skills são lidas quando a conversa começa, então uma adicionada no meio de uma conversa não aparece nela.
4. Confira. Digite só uma barra na caixa de mensagem. Aparece uma lista, e o nome precisa estar nela.

O erro mais comum, de longe: pasta dentro da pasta. Se depois de descompactar você ficou com nome/nome/SKILL.md, o Claude não acha. O SKILL.md precisa estar direto dentro da pasta que está em skills. É a causa em oito de cada dez casos de "coloquei e não aparece".

Se você prefere ir por plugin, o comando /plugin abre o marketplace, e ele coloca tudo no lugar certo sozinho.

Exemplos de skills úteis, por área

O que separa uma útil de uma curiosidade é ela resolver um trabalho que se repete. Alguns exemplos, de áreas diferentes:

Documentos. Os pacotes oficiais de Word, PowerPoint, Excel e PDF: o Claude passa a gerar e editar esses arquivos de verdade, com formatação, e não só texto para você colar.

Desenvolvimento. Revisão de código, escrita de teste, padrão de commit. É onde a maior parte da comunidade está.

Marketing, que é o que me interessa. Alguns dos trabalhos que já viraram custom skills por aqui:

• Auditoria de SEO on-page: lê a página, confere dezenas de itens, mostra o dado que provou cada veredito, e devolve um relatório pronto para o cliente.
• Campanha de vendas no Meta: decide estrutura, calcula verba de breakeven, escreve copy e nome de conjunto, e checa se a página de destino tem Pixel antes de deixar você publicar.
• Relatório mensal de campanha: o documento que toda agência refaz no fim do mês, saindo do mesmo jeito toda vez.
• Calendário editorial: o mês inteiro a partir do perfil do negócio, em vez da folha em branco.
• Perfil do negócio: uma entrevista que grava quem é o cliente, o que vende e como fala, para todos os outros processos lerem antes de trabalhar.

Repare no padrão: cada um deles termina num entregável, não numa resposta. É a diferença entre um processo de trabalho e um prompt bem escrito.

Como criar uma skill no Claude Code

Criar é mais simples do que parece, e é o que faz o Claude Code deixar de ser ferramenta dos outros e virar sua.

1. Escolha um trabalho que se repete. Não comece pela ideia mais ambiciosa. Comece pelo relatório que você faz toda semana, pela auditoria que você refaz à noite. Um trabalho, um arquivo.

2. Crie a pasta e o arquivo. .claude/skills/nome/SKILL.md. Nome curto, minúsculo, com hífen.

3. Escreva o cabeçalho. Nome e descrição, em YAML. Gaste tempo na descrição: ela deve dizer o que faz e quando usar, com as palavras que você usaria ao pedir. "Auditoria de SEO on-page de uma URL, com relatório para o cliente" é uma descrição que dispara na hora certa. "Ajuda com SEO" não é.

4. Escreva o corpo como você explicaria a um colega novo. Os passos, na ordem. O que conferir em cada um. O que fazer quando um dado não estiver disponível. O formato exato da entrega. Se você tem um modelo de relatório, ponha em references e mande usar.

5. Tire do texto o que pode virar script. Se um passo é determinístico (baixar uma página, contar palavras, calcular breakeven), escreva um script pequeno na pasta scripts e mande rodá-lo, em vez de pedir para o modelo "ter cuidado". Modelo erra em conta; script não.

6. Teste com caso real e ajuste. Rode num trabalho de verdade, veja onde quebrou, corrija o SKILL.md. Um bom processo nasce na terceira rodada, não na primeira.

O próprio Claude Code ajuda nisso: peça a ele para criar uma skill a partir do que você acabou de fazer numa conversa, e ele monta a pasta e o arquivo. Depois você revisa.

Boas práticas que separam a boa da que ninguém usa

• Descrição precisa. É o gatilho. Se dispara errado, ninguém confia.
• SKILL.md enxuto, referências profundas. O arquivo principal diz o caminho; o detalhe fica em references e só é aberto quando precisa.
• Trabalho determinístico em script. Conta, download, comparação: tudo que tem resposta certa vai para código.
• Formato de entrega definido. Termina em quê? Relatório, plano, tabela? Se não está escrito, cada execução termina diferente.
• Mostrar o trabalho. Item aprovado aparece com o dado que provou. É o que separa um relatório confiável de uma lista de checkmarks.

Como testar e resolver problemas

Não aparece na lista da barra. Confira, nesta ordem: pasta dentro da pasta; o SKILL.md está no lugar certo (.claude/skills/nome/SKILL.md); você começou uma conversa nova depois de adicionar.

Não dispara sozinha. A descrição não bate com o jeito que você pede. Reescreva a descrição com as suas palavras, ou chame pelo nome com a barra.

Dispara na hora errada. Descrição ampla demais. Deixe mais específica e diga também quando não usar.

O resultado sai diferente a cada vez. Falta formato de entrega definido, ou um passo que devia ser script está sendo feito pelo modelo.

Como compartilhar com a equipe

Se o pacote está em .claude/skills/ dentro da pasta do projeto, ele já viaja com a pasta: quem clonar o repositório ou receber a pasta recebe junto. É o jeito mais simples para equipe pequena.

Para distribuir para mais gente, ou várias de uma vez, o formato é plugin, publicado num marketplace, instalável com um comando. É assim que uma biblioteca inteira chega a quem não quer saber de pasta nenhuma.

Perguntas frequentes

Preciso saber programar para usar skills? Não. Para usar, você baixa, arrasta para a pasta e pede o trabalho em português. Para criar, também não: o SKILL.md é texto. Script é opcional, e o próprio Claude Code escreve se você pedir.

Skill funciona no ChatGPT? Não. É um formato do Claude Code e do padrão Agent Skills. Outros agentes que adotarem o padrão passam a ler o mesmo arquivo, mas o ChatGPT não é um deles hoje.

Skill é o mesmo que comando de barra? Hoje, na prática, sim: elas aparecem na lista da barra e podem ser chamadas pelo nome. A diferença é que também disparam sozinhas quando o pedido combina com a descrição, e podem carregar scripts e referências.

Quantas posso ter? Muitas, sem problema. Só o cabeçalho de cada uma é lido no início da conversa; o corpo só entra quando é usada.

Onde vejo as que já tenho? Digite uma barra na caixa de mensagem: a lista mostra todas as disponíveis naquela conversa.