Skills do Claude: o que são, onde ficam e como criar a sua

O que é uma skill no Claude Code

Uma skill é um procedimento escrito. Em vez de colar no chat as mesmas instruções toda vez que precisa de um relatório, de um post ou de uma revisão, você grava essas instruções num arquivo e o Claude passa a ter aquilo como ferramenta.

O arquivo tem duas partes. No topo, entre duas linhas ---, vai um cabeçalho em YAML com a description: o que a skill faz e quando usar. Embaixo vem o corpo, em Markdown, com os passos que o Claude segue.

A diferença para o CLAUDE.md é de custo. O CLAUDE.md entra inteiro em toda conversa. Da skill, só a descrição fica sempre no contexto; o corpo carrega quando a skill é usada. Por isso um procedimento longo, com checklist e exemplos, quase não pesa até o momento em que você precisa dele.

As skills do Claude Code seguem o padrão aberto Agent Skills, o que significa que a mesma pasta funciona em outras ferramentas de IA que adotaram o formato.

Onde ficam as skills do Claude

O lugar onde você salva a skill decide onde ela vale:

Onde	Caminho	Vale para
Pessoal	~/.claude/skills/<nome>/SKILL.md	todos os seus projetos nesta máquina
Projeto	.claude/skills/<nome>/SKILL.md	só aquele repositório; vai no git para quem trabalha nele
Plugin	<plugin>/skills/<nome>/SKILL.md	onde o plugin estiver ativo, como /plugin:nome

Para quem atende vários clientes, a pasta de projeto é a que importa. A skill que escreve no tom do cliente A fica no repositório do cliente A e não contamina o trabalho do cliente B.

Skill e comando: qual a diferença

Na prática, nenhuma. Os comandos personalizados foram unidos às skills: .claude/commands/relatorio.md e .claude/skills/relatorio/SKILL.md criam o mesmo /relatorio. Os arquivos antigos em .claude/commands/ continuam funcionando.

A skill ganha em três pontos: tem uma pasta para arquivos de apoio (um modelo, um script, um exemplo), pode ser chamada pelo Claude sem você digitar o comando, e deixa você controlar quem pode chamá-la.

Esse controle é o ponto que mais importa num negócio. Com disable-model-invocation: true no cabeçalho, o Claude não roda a skill por conta própria: só você, digitando /nome. É o que se usa em tudo que tem efeito fora da sua máquina, como publicar um post, subir um site ou mexer numa campanha. Você não quer o Claude decidindo que a peça “parece pronta” e publicando.

Como criar a sua primeira skill

O exemplo abaixo é uma skill de relatório semanal de anúncios. Ela não publica nada, então o Claude pode chamá-la sozinho quando você perguntar como foi a semana.

1. Crie a pasta: ~/.claude/skills/relatorio-semanal/
2. Dentro dela, crie o SKILL.md:

---
description: Resume a semana de anúncios em decisões. Use quando pedirem
  relatório semanal, "como foi a semana" ou análise de campanha.
---

1. Leia o CSV de campanhas que o usuário indicar.
2. Compare custo por venda desta semana com a média das 4 anteriores.
3. Liste no máximo 3 decisões, cada uma com o número que a justifica.
4. Termos com gasto e zero vendas: sugira negativar, nunca negative sozinho.

3. Teste de dois jeitos: pergunte “como foi a semana dos anúncios?” e veja se o Claude carrega a skill, ou digite /relatorio-semanal.

Três cuidados que separam uma skill que funciona de uma que é ignorada:

• A descrição decide tudo. Coloque primeiro o uso principal e as frases que você realmente fala. O texto da descrição é cortado em 1.536 caracteres na lista que o Claude lê.
• Passos verificáveis. “Faça um bom relatório” não é passo. “No máximo 3 decisões, cada uma com o número” é.
• Diga o que a skill não faz. O passo 4 do exemplo existe para o Claude recomendar e você decidir.

Quais skills valem a pena no marketing de um negócio

A melhor skill é a que tira da sua semana uma tarefa repetida e entrega o resultado no destino. Uma forma prática de achar as suas: anote tudo o que você explicou ao Claude mais de duas vezes no último mês. Cada item da lista é uma skill.

O Claude Code já traz skills embutidas, como /code-review e /debug, mas elas são para quem programa. No marketing de um negócio, as tarefas que mais se repetem são outras:

• Site: montar, publicar e confirmar que o endereço serve a versão nova.
• Artigo de blog: pesquisar a busca, escrever com a resposta no primeiro parágrafo e as perguntas reais no FAQ.
• Carrossel e legendas: slides na identidade da marca e texto para cada rede.
• Google Ads: campanha de pesquisa sem correspondência ampla e um relatório que vira decisão.
• Avaliações do Google: resposta no tom da marca, para você aprovar.

Cada uma dessas pode ser escrita do zero com o método acima. O que dá trabalho não é o arquivo: são os casos em que a skill erra, e cada um vira mais uma linha nas instruções.

Um pacote pronto, se você não quer escrever do zero

O NutekOS é um conjunto de 17 skills de marketing que roda no seu Claude Code. O /criar-site publica o site do cliente, o /publicar-tema escreve o artigo (este foi escrito seguindo o formato dele), o /carrossel monta os slides, o /anuncio-google monta a campanha e o /aprovar-post só publica com o seu sim. Para o que é só do seu negócio, o /mapear-rotinas faz as perguntas e cria skill nova para a tarefa que você repete.

Ele não ensina a programar e não substitui o Claude Code: precisa da sua assinatura do Claude Code, do Node e do git instalados.