Claude Skills: O Que São, Como Instalar e Como Criar as Suas (2026)

Claude Skills são pastas de instruções e recursos que ensinam uma capacidade específica ao Claude — formatar contratos, gerar diagramas, preencher planilhas, testar web apps. Cada skill tem um arquivo SKILL.md com nome, descrição e instruções de uso, e pode incluir scripts, templates e arquivos de referência. O Claude carrega a skill sob demanda, só quando a conversa pede aquele tipo de tarefa, e segue as instruções como seguiria um manual de time.

Este guia responde à pergunta que chega em buscas e em conversas com assistentes: “como funcionam as skills do Claude e como eu crio a minha?”. Resposta direta primeiro, depois anatomia, instalação, criação passo a passo, exemplos de uso real e os limites de segurança que valem antes de instalar skill de terceiros.

Resposta rápida: qual skill para cada problema

Regra prática: se o problema é “o Claude não sabe como o seu trabalho é feito”, a resposta é skill. Se é “o Claude não consegue alcançar um sistema externo”, a resposta é MCP ou conector.

O que são as Claude Skills

Uma skill é a versão empacotada daquele prompt longo que você cola todo dia. Em vez de colar, você escreve uma vez em SKILL.md e o Claude passa a carregar aquelas instruções quando a tarefa aparece.

A anatomia é mínima:

minha-skill/
├── SKILL.md          # Obrigatório: nome, descrição e instruções
├── templates/        # Opcional: modelos de documento
├── scripts/          # Opcional: código executável
└── referencia.md     # Opcional: guia de domínio, glossário

O SKILL.md começa com um frontmatter curto:

---
name: relatorio-semanal
description: Gera o relatório semanal de vendas no padrão
  da empresa, com tabela por região e conclusão em 3 bullets.
---

# Relatório semanal

1. Cole os dados brutos do CRM.
2. Monte a tabela por região no template em templates/base.md.
3. Destaque variação acima de 10% em relação à semana anterior.
4. Encerre com 3 bullets de conclusão e 1 ação recomendada.

Dois campos importam mais do que parecem:

• name: identificador único, sem espaços, usado para chamar a skill.
• description: é o que o Claude lê para decidir se carrega a skill. Descreva o gatilho (“quando o usuário pedir X, use esta skill”), não só o conteúdo. Descrição vaga = skill que nunca é chamada.

O mecanismo por trás é divulgação progressiva: a lista de skills com nome e descrição fica sempre visível; o corpo completo do SKILL.md só entra no contexto quando a skill é acionada. Por isso skills mal descritas falham em silêncio — o Claude nunca chega a abri-las.

Como usar skills no Claude

Onde a skill mora depende de onde você usa o Claude:

No Claude Code, o caminho mais comum é versionar as skills do projeto no repositório:

meu-projeto/
└── .claude/
    └── skills/
        └── relatorio-semanal/
            └── SKILL.md

Todo mundo do time que clona o repositório herda as skills — sem instalar nada, sem copiar prompt de um direct mal copiado. Para verificar o que está carregado, basta perguntar ao Claude quais skills ele enxerga ou listar a pasta.

Como criar a sua primeira skill em 15 minutos

1. Escolha a tarefa repetitiva que você mais reexplica ao Claude (relatório, padronização de documento, roteiro de deploy).
2. Cole o prompt longo que você usa hoje como rascunho do corpo do SKILL.md.
3. Escreva a description pensando no gatilho: “quando o usuário pedir X, use esta skill”. Teste pedir X em uma frase diferente da sua.
4. Mova templates e roteiros para arquivos separados dentro da pasta — o SKILL.md fica enxuto e o contexto limpo.
5. Teste o limite: peça uma tarefa parecida com X e confirme que a skill não dispara quando não deve.
6. Versione a pasta no repositório (projeto) ou copie para ~/.claude/skills/ (global).

O erro número um é escrever a skill como documentação (“esta skill faz…”) em vez de instrução direta ao agente (“quando ativada, siga estes passos”). A skill não é um README para humanos — é ordem de serviço para o modelo.

Exemplos de skills que valem o trabalho

Casos que aparecem de verdade no dia a dia de quem opera agentes:

• Padronização de documentos — contratos, propostas e relatórios que precisam sair sempre no layout da casa, com cláusulas e seções fixas.
• Roteiros de operação — checklist de deploy, triagem de incidente, rotina de fechamento mensal: o roteiro inteiro embutido, sem depender de memória do modelo.
• Vocabulário de domínio — glossário do seu setor (jurídico, clínico, financeiro) que corrige terminologia antes de o texto sair errado.
• Geração de artefatos repetitivos — planilhas com fórmulas padrão, diagramas de arquitetura no mesmo estilo, apresentações que seguem identidade.
• Pós-processamento de código — skill que roda lint, formata e gera changelog com o formato do time após cada entrega.

Em cada um deles, o ganho não é “o Claude fica mais inteligente” — é consistência: a centésima execução sai igual à primeira.

Skills vs plugins vs hooks vs MCP

As quatro camadas se confundem em conversa, mas têm papéis distintos:

Elas se combinam, não competem: uma skill pode mandar o agente usar um servidor MCP; um hook pode auditar o que a skill executou.

Claude Skills e OpenClaw: quem cuida do quê

O OpenClaw usa o mesmo formato de skill — pasta com SKILL.md, scripts e recursos — mas as skills do OpenClaw operam no gateway: WhatsApp, Telegram, rotinas agendadas, fluxos com aprovação humana. Na prática:

• Claude Skills ensinam capacidades ao agente dentro da sessão (web, API, Claude Code).
• Skills do OpenClaw levam essas capacidades para os canais e automações do dia a dia — atendimento no WhatsApp, monitoramento de madrugada, alertas de CRM.

Se o seu problema é operação fora do terminal, veja como instalar e publicar skills no ClawHub, o marketplace de skills do OpenClaw, e o guia de como criar skills para o OpenClaw.

Segurança: skill de terceiros é código de terceiros

Antes de instalar uma skill que você não escreveu:

• Leia o SKILL.md inteiro — instruções podem mandar o agente exfiltrar dados ou visitar endpoints estranhos.
• Revise todo script da pasta antes da primeira execução; skill não é texto inerte, pode carregar código.
• Prefira repositórios versionados que você controla (fork antes de confiar) a colar pastas de fontes voláteis.
• Segredos ficam fora da skill — use variável de ambiente e permissão explícita, nunca token escrito no SKILL.md.

A mesma regra vale para hooks de terceiros: configuração herdada de repositório clonado merece revisão antes de confiar.

Erros comuns

• Skill nunca dispara → a description não descreve o gatilho. Reescreva como “quando o usuário pedir X”.
• Skill dispara demais → descrição genérica demais (“ajuda com documentos”). Restrinja o escopo.
• Instruções ignoradas pela metade → SKILL.md gigante. Mova detalhe para arquivos de referência e mantenha o corpo enxuto.
• Time inteiro sem a skill → a pasta está em ~/.claude/skills/ (local) em vez de .claude/skills/ do repositório (compartilhada).
• Resultado inconsistente entre execuções → falta template fixo; o modelo improvisa o formato quando não há arquivo de apoio.

FAQ

O que são Claude Skills?

São pacotes de instruções e recursos — um SKILL.md com nome, descrição e passos, mais scripts, templates e arquivos de referência opcionais — que ensinam uma capacidade específica ao Claude. O modelo carrega a skill sob demanda, quando a conversa pede aquele tipo de tarefa.

Como instalar skills no Claude?

No claude.ai, em Settings → Capabilities → Skills, habilitando as disponíveis ou conectando um repositório GitHub. No Claude Code, colocando a pasta da skill em .claude/skills/ do projeto (compartilhada com o time via git) ou em ~/.claude/skills/ (global para o usuário).

Como criar uma skill do Claude?

Crie uma pasta com um arquivo SKILL.md contendo frontmatter com name e description e, no corpo, as instruções diretas ao agente. Adicione templates e scripts conforme a necessidade e coloque a pasta no diretório de skills. A description deve descrever quando usar a skill, porque é ela que dispara o carregamento.

Qual a diferença entre skills e plugins do Claude?

Skills ensinam um jeito de fazer — instruções, roteiros e templates que o modelo segue. Plugins empacotam capacidades prontas (comandos, agentes, configurações) para instalar de uma vez. As duas camadas se complementam: um plugin pode até distribuir skills.

Qual a diferença entre skills e MCP?

Skill é conhecimento de procedimento: ensina o agente a como executar um trabalho. MCP é conexão: dá ao agente acesso a sistemas externos como APIs, bancos e serviços. Uma skill pode orientar o uso de um servidor MCP durante a execução.

As skills do Claude funcionam no WhatsApp?

No Claude puro, não — elas operam na sessão onde o Claude roda (web, API, Claude Code). Para levar capacidades de skill a canais como WhatsApp e Telegram, o caminho é o OpenClaw, que usa o mesmo formato de skill no gateway de automação.

O que é o arquivo SKILL.md?

É o arquivo obrigatório de toda skill: um markdown com frontmatter (name e description) e o corpo com as instruções que o Claude segue quando carrega a skill. É a peça que decide se a skill dispara (descrição) e o que ela faz (instruções).

Skills do Claude são seguras?

As que você escreve, sim — rodam sob sua conta e permissões. O risco está em skills de terceiros: leia o SKILL.md e revise os scripts antes da primeira execução, prefira repositórios versionados e nunca grave segredos dentro da skill.

Próximo passo

1. Escolha o prompt que você mais cola repetidamente e transforme-o em SKILL.md hoje — 15 minutos.
2. Versione a skill no .claude/skills/ do projeto para o time herdar.
3. Para controlar o que o agente executa, adicione hooks; para conectá-lo a serviços, comece pelo MCP.
4. Quando a skill precisar operar fora do terminal — WhatsApp, rotinas, aprovação — leve-a para o OpenClaw e publique no ClawHub.

Skill bem escrita é o seu conhecimento operacional rodando sem você. Comece por uma, hoje.