Como Instalar Skills no Claude Code — Guia Passo a Passo (2026)

O que sao skills e por que instalar

Skills sao arquivos Markdown (.md) que voce adiciona ao Claude Code para dar a ele conhecimento especializado sobre um assunto. Sem skills, o Claude usa apenas o conhecimento geral do modelo. Com skills, ele passa a seguir frameworks, regras e boas praticas de uma area especifica.

Na pratica, uma skill funciona como um briefing detalhado. Imagine que voce contratou um copywriter e, antes de ele comecar, entregou um documento com o tom de voz da marca, os frameworks que ele deve usar (PAS, AIDA, BAB), os erros que ele nunca deve cometer e exemplos do tipo de resultado que voce espera. Isso e uma skill.

A diferenca e que voce configura uma vez e o Claude segue essas instrucoes automaticamente em toda conversa que usar aquela skill. Nao precisa repetir o prompt toda vez.

O Claude Code suporta dois tipos de instalacao:

• Skills locais (por projeto): ficam na pasta .claude/skills/ dentro do diretorio do projeto. Sao carregadas apenas quando voce abre o Claude Code naquele projeto.
• Skills globais (todos os projetos): ficam em ~/.claude/skills/ na pasta home do seu usuario. Sao carregadas em qualquer projeto que voce abrir.

Para a maioria dos usos, skills globais sao a melhor opcao — voce instala uma vez e elas ficam disponiveis em todo lugar.

Pre-requisitos

Antes de comecar, confirme que voce tem:

• Claude Code instalado — se ainda nao instalou, siga a documentacao oficial da Anthropic em docs.anthropic.com. O Claude Code roda no terminal (Mac, Linux ou Windows com WSL).
• Terminal aberto — no Mac, use o Terminal ou iTerm2. No Linux, qualquer emulador de terminal. No Windows, use o WSL (Windows Subsystem for Linux).
• Acesso ao pacote de skills — voce recebe o link de download por e-mail imediatamente apos a compra.

Passo 1 — Baixar o pacote de skills

Apos a compra, voce recebe um e-mail com o link de download. O arquivo vem em formato .zip contendo todos os arquivos .md organizados por categoria.

Clique no link e salve o arquivo na pasta Downloads do seu computador. O nome do arquivo vai ser algo como minhaskills-mega-bundle.zip ou minhaskills-mega-bundle.zip.

Passo 2 — Extrair os arquivos

Voce pode extrair pelo Finder (Mac), explorador de arquivos (Linux) ou pelo terminal. Pelo terminal e mais rapido:

Apos a extracao, voce tera uma pasta com todos os arquivos .md organizados. Cada arquivo e uma skill independente.

Passo 3 — Copiar para a pasta correta

Agora voce precisa copiar os arquivos para onde o Claude Code procura skills. Voce tem duas opcoes:

Opcao A: Instalacao global (recomendada)

Skills globais ficam disponiveis em todos os projetos. Ideal para skills que voce usa frequentemente.

Opcao B: Instalacao local (por projeto)

Skills locais ficam dentro de um projeto especifico. Ideal para skills que fazem sentido apenas naquele contexto.

Passo 4 — Verificar que o Claude detectou

O Claude Code carrega skills automaticamente ao iniciar uma conversa. Nao existe um comando "instalar" — se o arquivo .md esta na pasta certa, o Claude ja consegue usa-lo.

Para confirmar, abra o Claude Code e pergunte diretamente:

O Claude vai listar as skills que ele detectou. Se voce instalou o Mega Bundle, ele deve mencionar as skills de copywriting, SEO, tracking, etc.

Outra forma de verificar e usar o comando /skills dentro do Claude Code (disponivel em versoes recentes). Ele mostra a lista de skills carregadas na sessao atual.

Passo 5 — Testar com um prompt

A melhor forma de testar e pedir algo que a skill cobre. Por exemplo, se voce instalou a skill de copywriting para ads:

Sem a skill, o Claude geraria headlines genericas. Com a skill de copywriting, ele vai aplicar frameworks como PAS (Problem-Agitation-Solution), usar gatilhos mentais adequados para o publico e seguir as boas praticas de copy para anuncios de redes sociais — tudo automaticamente.

Voce vai notar a diferenca na qualidade e na especificidade das respostas. O Claude para de "inventar" e comeca a seguir processos profissionais.

Estrutura de pastas completa

Para referencia, esta e a estrutura de pastas que o Claude Code espera:

Regras importantes:

• Os arquivos devem ter extensao .md (Markdown)
• O nome do arquivo nao importa para o Claude — ele le o conteudo, nao o nome. Mas nomes descritivos ajudam voce a se organizar.
• Voce pode criar subpastas dentro de skills/ para organizar por categoria (ex: skills/marketing/, skills/dev/)
• Nao ha limite de skills. Voce pode ter dezenas ou centenas de arquivos.
• Skills locais do projeto tem prioridade sobre skills globais se houver conflito.

Exemplo pratico: instalar e usar skill de copywriting

Vamos fazer o processo completo do zero. Suponha que voce acabou de comprar o Mega Bundle.

1. Download e extracao

2. Instalacao global

3. Abrir o Claude Code e testar

Com a skill de copywriting para email instalada, o Claude vai:

• Usar a estrutura adequada para emails de lancamento (assunto, preview text, corpo, CTA)
• Aplicar gatilhos mentais relevantes para o publico
• Seguir boas praticas de deliverability (comprimento, formatacao, links)
• Incluir variacoes de subject line para teste A/B

Tudo isso sem voce precisar explicar no prompt como escrever um bom email. A skill ja contem essas instrucoes.

Troubleshooting: skills nao aparecem?

Se voce instalou as skills mas o Claude nao parece usa-las, verifique esses pontos:

1. Pasta errada

O erro mais comum. Confirme o caminho exato:

2. Extensao errada

Os arquivos devem ter extensao .md. Verifique se nao ficaram com .md.txt ou outra extensao dupla (comum no Windows):

3. Conversa antiga

O Claude carrega skills no inicio de cada conversa. Se voce adicionou skills com uma conversa ja aberta, o Claude pode nao te-las carregado. Solucao:

Ou feche e reabra o Claude Code no terminal.

4. Permissoes de arquivo

O Claude Code precisa de permissao de leitura nos arquivos. Se voce copiou de uma fonte externa, verifique:

5. Arquivo vazio ou corrompido

Verifique se o arquivo tem conteudo:

Se o arquivo tem 0 linhas, a extracao do ZIP pode ter falhado. Baixe novamente e reextraia.