kntrIA Conhecer o kntriaOS
Início › kntriaOS › Guias › Claude Code skills
Guia de Claude Code

Claude Code skills: o que são e como criar a sua

Skill é o jeito de ensinar um processo ao Claude Code uma vez e chamar com uma barra. Veja onde ela mora, como escrever o SKILL.md e quais valem a pena para marketing.

Por equipe kntrIA · Atualizado em

Claude Code skills: o que são e como criar a sua: kntrIA, empresa de inteligência artificial de Indaiatuba

Skills do Claude Code são pastas com um arquivo SKILL.md que ensinam um processo ao Claude. Ele carrega a skill sozinho quando o pedido combina com a descrição, ou você chama com /nome-da-skill.

Skills do Claude Code resolvem um problema concreto: parar de colar o mesmo passo a passo no chat toda vez. Você escreve o processo uma vez, num arquivo Markdown, e o Claude passa a seguir aquilo sempre que a tarefa aparece. Este guia segue a documentação oficial de skills do Claude Code, consultada em 14 de outubro de 2026. Recurso de software muda rápido, então os nomes de campo e as pastas abaixo valem para essa data.

O que são skills no Claude Code?

Uma skill é uma pasta com um arquivo SKILL.md. O arquivo tem duas partes: um cabeçalho em YAML (o frontmatter) que diz quando usar, e o corpo em Markdown com as instruções. A pasta pode levar também arquivos de apoio, como exemplos, modelos e scripts.

Ela funciona de dois jeitos:

  • Automático. O Claude lê o nome e a descrição de todas as skills no começo da sessão. Quando o seu pedido combina com uma descrição, ele carrega o corpo daquela skill e segue.
  • Manual. Você digita /nome-da-skill no começo da mensagem, com ou sem argumentos.

A vantagem está no custo: só nome e descrição ficam no contexto o tempo todo. O corpo, que pode ser longo, só entra quando é usado. A documentação recomenda criar uma skill quando você cola o mesmo checklist pela terceira vez, ou quando um trecho do CLAUDE.md virou procedimento em vez de regra.

Onde ficam as skills do Claude Code?

O lugar onde você salva decide em quais sessões a skill aparece:

EscopoCaminhoVale em
Pessoal~/.claude/skills/<nome>/SKILL.mdTodos os seus projetos nesta máquina
Projeto.claude/skills/<nome>/SKILL.mdSessões dentro do repositório (vai para o Git e a equipe recebe)
Subpasta<subpasta>/.claude/skills/<nome>/SKILL.mdSessões abertas naquela subpasta ou abaixo dela
Plugin<plugin>/skills/<nome>/SKILL.mdOnde o plugin estiver ativo, como /plugin:nome
Empresa.claude/skills/ no diretório de configurações gerenciadasTodos os usuários das máquinas onde a organização instalar

Se duas skills têm o mesmo nome, a da empresa vence a pessoal, e a pessoal vence a de projeto. E um detalhe que confunde: os antigos comandos personalizados em .claude/commands/ continuam funcionando. Segundo a doc, um arquivo .claude/commands/deploy.md e uma skill .claude/skills/deploy/SKILL.md criam o mesmo /deploy. Para coisa nova, a recomendação oficial é usar skill.

Como é o formato do SKILL.md?

Todos os campos do frontmatter são opcionais, mas a description é a que faz a skill ser achada. Os campos que você mais vai usar:

  • name: o nome do comando. Se ficar de fora, vale o nome da pasta.
  • description: o que a skill faz e quando usar. Coloque o caso principal primeiro, porque descrição e when_to_use juntas são cortadas em 1.536 caracteres na lista.
  • argument-hint: a dica que aparece no autocompletar, como [tema do post].
  • disable-model-invocation: true: só você chama, o Claude não dispara sozinho.
  • user-invocable: false: some do menu /, só o Claude usa. Bom para skill de referência.
  • allowed-tools: ferramentas liberadas sem pedir permissão durante o turno que chamou a skill.
  • context: fork com agent: roda a skill num subagente, com contexto isolado.

No corpo, $ARGUMENTS recebe tudo o que você digitou depois do nome, e $0, $1 pegam argumentos por posição. Uma linha com !`comando` roda o comando no shell antes de mandar a skill ao Claude e troca a linha pela saída. Isso serve para injetar dado vivo, como o git diff atual.

Skill, slash command, subagente, hook e MCP: qual a diferença?

São cinco peças que se completam. A página de extensões do Claude Code compara todas; o resumo prático é este:

PeçaO que éOnde ficaQuando usar
SkillInstruções e arquivos de apoio que carregam sob demanda.claude/skills/Processo repetível ou material de referência
Slash commandArquivo Markdown que vira /nome (hoje faz parte das skills).claude/commands/Atalho simples para um prompt que você digita sempre
SubagenteUm trabalhador com contexto próprio que devolve só o resumo.claude/agents/Tarefa que lê muito arquivo, trabalho em paralelo, revisão independente
HookScript que roda sempre que um evento acontecesettings.jsonRegra que não pode depender da memória do Claude
MCPConexão com serviço ou ferramenta externa.mcp.json ou ~/.claude.jsonLer ou agir em banco, navegador, API de terceiros

A regra que mais evita dor de cabeça: se a instrução precisa valer toda vez, sem exceção, ela vai para um hook, não para uma skill. A própria doc avisa que o Claude pode deixar de seguir uma skill depois de muitas mensagens ou de uma compactação da conversa. Hook roda pelo sistema, não pela memória do modelo. Para conectar ferramentas de fora, veja o guia de MCP no Claude Code.

Como criar uma skill no Claude Code (exemplo real)

Vamos criar uma skill de projeto que escreve legenda de Instagram seguindo o tom de voz da marca. Ela assume que o projeto tem um arquivo _contexto/tom-de-voz.md com o jeito de falar do cliente.

1. Crie a pasta da skill dentro do projeto:

mkdir -p .claude/skills/legenda-instagram

2. Salve o arquivo .claude/skills/legenda-instagram/SKILL.md:

---
description: Escreve legenda de Instagram na voz da marca. Use quando pedirem legenda, texto de post ou copy curta para Instagram.
argument-hint: [tema do post]
---

Escreva uma legenda de Instagram sobre: $ARGUMENTS

1. Leia _contexto/tom-de-voz.md antes de escrever e use as palavras que a marca usa.
2. Primeira linha: gancho com no máximo 12 palavras.
3. Corpo: até 4 parágrafos curtos, um assunto por parágrafo.
4. Termine com uma chamada para ação específica (nada de "saiba mais").
5. No fim, sugira de 3 a 5 hashtags do nicho.
6. Nunca invente preço, número ou depoimento.

Entregue só a legenda, pronta para colar.

3. Teste dos dois jeitos. Abra o Claude Code na pasta do projeto com claude. Peça "escreve a legenda do post sobre o horário de Natal" e veja se ele carrega a skill sozinho. Depois chame direto:

/legenda-instagram horário de funcionamento no Natal

Se ele não usar a skill automaticamente, a descrição está fraca. Coloque as palavras que você realmente usa no pedido. Para confirmar que ela foi carregada, pergunte "What skills are available?", como sugere a doc, ou rode com --debug para ver erro de YAML.

Boas práticas para escrever skills

  1. Descrição com o gatilho real. Escreva como você pede: "legenda", "post", "carrossel", não termos que só você entende.
  2. O mais importante no topo. Depois de uma compactação, o Claude Code pode manter só o começo de uma skill já usada.
  3. SKILL.md abaixo de 500 linhas. Material longo vai em arquivo de apoio (exemplos.md, referencia.md) citado no SKILL.md, para o Claude ler só quando precisar.
  4. Trava em tudo que tem efeito colateral. Skill que publica, envia e-mail ou apaga arquivo leva disable-model-invocation: true.
  5. Instrução que vale para a tarefa inteira. "Rode o teste depois de cada edição" funciona melhor que "rode o teste".
  6. Uma skill, um processo. Skill que faz tudo vira skill que dispara na hora errada.
  7. Versione no Git. Skill de projeto em .claude/skills/ vai junto com o repositório, e a equipe inteira passa a trabalhar igual.

Exemplos de skills úteis para marketing e agência

Para quem produz conteúdo para vários clientes, as skills que mais economizam tempo são as que tiram o retrabalho de briefing e revisão:

Legenda na voz da marca

Lê o tom de voz do cliente e entrega legenda com gancho, corpo e chamada. É o exemplo deste guia.

Revisão de português

Skill de referência com as regras de crase, regência e as palavras proibidas do cliente. Marque user-invocable: false e deixe o Claude usar quando revisar texto.

Calendário do mês

Recebe o mês e os objetivos e devolve dia, formato e tema de cada post. Um argument-hint: [mês] deixa o uso óbvio.

Carrossel em HTML

Monta os slides com as cores HEX e a fonte da marca e renderiza em imagem com um script na pasta da skill. O guia criar carrossel com IA detalha o processo.

Relatório mensal

Junta os números que você colar e escreve a análise no padrão da agência. Como envia para cliente, leva disable-model-invocation: true.

Proposta comercial

Usa um modelo HTML da pasta da skill e preenche escopo e prazo. Preço sempre vem de você, nunca da IA.

Se você ainda está instalando o Claude Code, comece pelo guia como usar o Claude Code do zero. E se o que pesa é o limite de uso, o guia de preço e planos do Claude Code mostra por que mover instruções do CLAUDE.md para skills também ajuda a gastar menos.

No kntriaOS isso já vem montado

O kntriaOS é exatamente esse conjunto de peças, já pronto para marketing. Ele chega com 14 comandos em .claude/commands/ (do /novo-cliente ao /aprender, passando por /criar-carrossel, /calendario-mes, /criar-proposta e /criar-site), 14 guias que cada comando lê antes de produzir, 1 subagente revisor que aprova ou reprova a entrega e 2 hooks: um carrega o cérebro do sistema ao abrir a sessão e outro procura travessão, texto de exemplo esquecido e vício de português a cada arquivo escrito. Cada cliente tem oito arquivos de DNA, então a skill de legenda deste guia já nasce sabendo a voz de cada um. Custa R$ 29,90 por mês e exige a sua assinatura do Claude Pro ou Max. Para empresas que preferem a solução pronta em vez de operar o terminal, a kntrIA faz marketing digital com IA sob medida.

Perguntas frequentes

Qual a diferença entre skill e slash command no Claude Code?

Hoje são a mesma coisa para quem usa: um arquivo em .claude/commands/nome.md e uma skill em .claude/skills/nome/SKILL.md criam o mesmo /nome. A skill acrescenta pasta para arquivos de apoio, controle de quem pode chamar e carregamento automático.

Onde ficam as skills do Claude Code?

As pessoais ficam em ~/.claude/skills/ e valem em todos os projetos da máquina. As de projeto ficam em .claude/skills/ dentro do repositório e podem ir para o Git, para a equipe inteira usar.

Skill gasta token o tempo todo?

Pouco. Só o nome e a descrição entram na lista que o Claude vê no começo da sessão. O corpo do SKILL.md só carrega quando a skill é usada.

Como impedir que o Claude rode uma skill sozinho?

Coloque disable-model-invocation: true no frontmatter. Ela continua disponível pelo /nome, mas o Claude não a dispara por conta própria. Use isso em tudo que publica, envia ou apaga.

Skill funciona fora do Claude Code?

A documentação cita o padrão aberto Agent Skills (agentskills.io) para o formato. Alguns campos do frontmatter são próprios do Claude Code e podem ser ignorados em outras ferramentas.

14 processos de marketing prontos para o seu Claude Code.

O kntriaOS chega com comandos de post, carrossel, calendário, proposta e site, um agente revisor e hooks já ligados. Você clona e produz no mesmo dia.