--- title: "Claude Skills: O Que São, Como Instalar e Como Criar as Suas (2026)" url: "https://openclaw.ia.br/blog/claude-skills-guia/" markdown_url: "https://openclaw.ia.br/blog/claude-skills-guia.MD" description: "Guia em português das Claude Skills: pacotes de instruções e arquivos que ensinam capacidades ao Claude. SKILL.md, instalação, criação, exemplos e limites." date: "2026-10-03" author: "OpenClaw Brasil" --- # Claude Skills: O Que São, Como Instalar e Como Criar as Suas (2026) Guia em português das Claude Skills: pacotes de instruções e arquivos que ensinam capacidades ao Claude. SKILL.md, instalação, criação, exemplos e limites. **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 | Problema | Skill resolve com | Resultado | |---|---|---| | Claude entrega documento fora do padrão do seu time | Skill com template + regras de formatação | Mesmo layout em toda entrega | | Tarefa repetitiva precisa de um roteiro de 15 passos | Skill com checklist em `SKILL.md` | O roteiro roda sem reexplicar nada | | Script próprio precisa rodar como parte da resposta | Skill com script versionado junto | Claude chama o script no momento certo | | Claude não conhece o jargão do seu domínio | Skill com glossário e exemplos | Respostas no vocabulário correto | | Você repete o mesmo prompt longo toda semana | Skill que embute o prompt | Um pedido curto dispara o fluxo inteiro | | Capacidade precisa de ferramenta externa | Aqui o par certo é MCP, não skill | Veja a tabela de comparação abaixo | **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](/blog/mcp-model-context-protocol-explicado/) 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: ```markdown --- 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: | Onde | Como a skill chega lá | Vale para | |---|---|---| | claude.ai (web) | Settings → Capabilities → Skills: habilite as oficiais ou conecte um repositório GitHub | Sua conta | | Claude Code | Pasta `.claude/skills/` no projeto (versionada com o time) ou `~/.claude/skills/` (global) | Projeto ou usuário | | API da Anthropic | Você envia os arquivos da skill junto ao request (container com `SKILL.md`) | Por chamada | 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: | Camada | O que faz | Parece com | |---|---|---| | **Skill** | Ensina um *jeito de fazer* (instruções, templates, scripts) | Manual de procedimento do time | | [**Plugin**](/blog/melhores-plugins-claude-code/) | Empacota comandos, agentes e configurações para instalar de uma vez | Extensão de aplicativo | | [**Hook**](/blog/claude-hooks-guia/) | Intercepta eventos para controlar, auditar ou vetar ações | Cerca e alarme | | [**MCP**](/blog/mcp-model-context-protocol-explicado/) | Conecta o agente a sistemas externos (APIs, bancos, serviços) | Cabo e adaptador | 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](/blog/clawhub-marketplace-skills-openclaw/), e o guia de [como criar skills para o OpenClaw](/skills/criar-skill/). ## 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](/blog/claude-hooks-guia/): 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](/blog/claude-hooks-guia/); para conectá-lo a serviços, comece pelo [MCP](/blog/mcp-model-context-protocol-explicado/). 4. Quando a skill precisar operar fora do terminal — WhatsApp, rotinas, aprovação — leve-a para o [OpenClaw](/instalacao/) e publique no [ClawHub](/blog/clawhub-marketplace-skills-openclaw/). Skill bem escrita é o seu conhecimento operacional rodando sem você. Comece por uma, hoje.