Skills no Claude Code sao arquivos de instrucao em formato Markdown (.md) que transformam o Claude em um especialista em qualquer area. Em vez de repetir os mesmos prompts toda vez que abre o terminal, voce instala uma skill e o Claude passa a responder com frameworks, regras e contexto profissional — automaticamente, sem voce copiar e colar nada.
Se voce ja usou o Claude Code para escrever codigo, criar textos ou analisar dados, sabe que o resultado depende muito de como voce faz o pedido. Skills resolvem esse problema: elas dao ao Claude o contexto que ele precisa antes de voce perguntar qualquer coisa.
Neste guia, vou explicar em detalhes tecnicos como skills funcionam no Claude Code, qual a estrutura de arquivos, como o Claude detecta e carrega essas instrucoes, e como instalar e comecar a usar hoje.
O que sao skills no Claude Code
Skills para Claude Code sao arquivos de texto no formato Markdown que contem instrucoes especializadas. Cada skill funciona como um "manual do especialista" que o Claude le antes de responder suas perguntas.
Na pratica, uma skill e um arquivo .md dentro de uma pasta especifica do seu projeto ou do seu sistema. Quando o Claude Code inicia uma sessao, ele varre essas pastas, identifica os arquivos de skill e carrega o conteudo como contexto adicional.
A diferenca para um prompt comum e fundamental:
- Prompt comum: voce digita instrucoes toda vez. Se fechar o terminal, perde tudo. O contexto some.
- Skill: arquivo permanente no seu disco. O Claude carrega automaticamente. Voce nunca mais precisa repetir aquela instrucao.
Pense em skills como a diferenca entre contratar um freelancer sem briefing (prompt) e contratar um profissional que ja leu todo o manual da sua empresa (skill). O segundo vai entregar resultados melhores desde o primeiro dia.
Skills podem conter qualquer tipo de instrucao: frameworks de copywriting, regras de SEO tecnico, padroes de codigo, templates de email, checklists de auditoria, workflows completos de desenvolvimento. Nao existe limite para o que uma skill pode ensinar ao Claude.
Como o Claude Code detecta skills
O Claude Code tem um sistema de deteccao automatica de skills. Quando voce inicia uma sessao, ele procura arquivos de instrucao em locais especificos do sistema de arquivos. A ordem de prioridade e:
- Pasta do projeto:
.claude/skills/dentro do diretorio do seu projeto atual - Pasta global do usuario:
~/.claude/skills/no diretorio home do usuario
O mecanismo funciona assim: ao iniciar o Claude Code em um diretorio, ele verifica se existe a pasta .claude/. Se existir, ele le os arquivos dentro de .claude/skills/. Arquivos com a extensao .md sao interpretados como skills e carregados no contexto da conversa.
Isso significa que voce pode ter skills por projeto (uteis para regras especificas de um cliente ou repositorio) e skills globais (uteis para regras que voce quer em todas as sessoes, como seu estilo de codigo ou tom de voz preferido).
# 1. Skills do projeto (especificas)
./projeto/.claude/skills/
# 2. Skills globais (todas as sessoes)
~/.claude/skills/
# O Claude le TODOS os .md dessas pastas
# e carrega como contexto automaticamente
Quando o Claude encontra um arquivo de skill, ele nao apenas le o texto — ele interpreta as instrucoes como regras de comportamento. Se uma skill diz "sempre responda em portugues e use tom profissional", o Claude vai seguir isso em toda a sessao.
Estrutura de pastas e arquivos
A organizacao das skills no sistema de arquivos segue um padrao simples. Veja a estrutura tipica de um projeto com skills instaladas:
├── .claude/
├ ├── skills/
├ ├ ├── copywriting.md
├ ├ ├── seo-tecnico.md
├ ├ ├── google-ads.md
├ ├ └── email-marketing.md
├ └── settings.json
├── src/
└── index.html
Cada arquivo .md dentro de .claude/skills/ e uma skill independente. O nome do arquivo nao importa para o funcionamento — o Claude le o conteudo, nao o nome. Mas e uma boa pratica usar nomes descritivos para voce se organizar.
Voce pode ter quantas skills quiser em uma pasta. O Claude carrega todas. Se duas skills tiverem instrucoes conflitantes, a mais especifica (a do projeto) tem prioridade sobre a global.
Skills globais vs. skills de projeto
Quando usar cada uma:
- Skills globais (
~/.claude/skills/): regras que voce quer em TODA sessao. Exemplo: "sempre responda em portugues", "use tabs em vez de espacos", "meu tom de voz e profissional e direto". - Skills de projeto (
./projeto/.claude/skills/): regras especificas daquele repositorio. Exemplo: "este projeto usa Next.js 14 com App Router", "a marca do cliente e formal", "o tracking usa GTM server-side".
Formato do arquivo SKILL.md
Uma skill e um arquivo Markdown comum. Nao existe um formato rigido — qualquer instrucao em texto funciona. Mas existe uma estrutura que produz melhores resultados, baseada em como o Claude interpreta contexto.
Um arquivo de skill bem estruturado geralmente tem:
# SEO Tecnico — Skill para Claude Code
## Papel
Voce e um especialista em SEO tecnico com 10+ anos
de experiencia em auditoria de sites, Core Web Vitals
e otimizacao de rastreamento.
## Regras
- Sempre priorize mobile-first
- Use dados estruturados Schema.org quando aplicavel
- Recomende URLs canonicas para evitar conteudo duplicado
- Nunca sugira tecnicas black-hat
## Frameworks de Referencia
- Core Web Vitals: LCP < 2.5s, CLS < 0.1, INP < 200ms
- Checklist de auditoria: [lista de 20+ itens]
- Template de relatatorio: [formato padrao]
## Exemplos de Output
[exemplos do formato de resposta esperado]
Os blocos mais importantes de uma skill sao:
- Papel (Role): define quem o Claude "e" nessa skill. Quanto mais especifico, melhor o resultado.
- Regras (Rules): limites e diretrizes que o Claude deve seguir. O que fazer e o que NAO fazer.
- Frameworks: modelos, templates, checklists e referencias tecnicas que o Claude deve usar.
- Exemplos: amostras do output esperado. Isso calibra o nivel de detalhe e formato das respostas.
Voce pode incluir tambem: links para documentacao, tabelas de referencia, snippets de codigo, workflows passo-a-passo. Quanto mais contexto util a skill tem, mais preciso o Claude fica.
Quer dominar isso mais rapido?
Tudo que voce esta aprendendo aqui fica 10x mais poderoso com skills prontas. Em vez de digitar comandos manualmente, as skills fazem o trabalho pesado. 748+ skills profissionais.
Quero as Skills — R$19Como instalar skills no Claude Code
Instalar skills no Claude Code e copiar arquivos para uma pasta. Nao existe compilacao, build, npm install ou qualquer outro passo tecnico. O processo inteiro leva menos de 2 minutos.
Passo 1: Criar a pasta de skills (se nao existir)
$ mkdir -p ~/.claude/skills
# Para skills de projeto (apenas este repositorio):
$ mkdir -p .claude/skills
Passo 2: Copiar os arquivos de skill
$ cp copywriting.md ~/.claude/skills/
# Copiar um pacote inteiro de skills:
$ cp -r skills/* ~/.claude/skills/
Passo 3: Abrir o Claude Code
Claude Code v1.x
# O Claude ja carregou as skills automaticamente.
# Nenhuma configuracao adicional necessaria.
> escreva uma headline para uma landing page de SaaS
# Com a skill de copywriting instalada, o Claude vai usar
# frameworks como PAS, AIDA, 4Us automaticamente — sem
# voce precisar pedir.
Pronto. Nao existe passo 4. As skills estao instaladas e o Claude Code ja esta usando.
Exemplos praticos de skills em acao
Para mostrar a diferenca que uma skill faz, veja o mesmo pedido com e sem skill instalada:
Exemplo 1: Copywriting — sem skill
Aprenda Marketing Digital do Zero ao Avancado
# Generico. Sem framework. Sem especificidade.
Exemplo 1: Copywriting — com skill instalada
Como Gerar 3x Mais Leads em 30 Dias Usando as Mesmas
Ferramentas que Voce Ja Tem — Mesmo que Nunca Tenha
Rodado um Anuncio na Vida
# Framework PAS aplicado automaticamente.
# Resultado especifico + prazo + reducao de objecao.
# A skill ensinou o Claude a pensar como copywriter.
Exemplo 2: SEO — com skill instalada
## Auditoria SEO Tecnica
- Title tag: 62 chars (OK, limite: 60)
- Meta description: ausente (CRITICO)
- H1: presente, contém keyword principal (OK)
- Schema markup: nenhum detectado (RECOMENDADO)
- Core Web Vitals estimado: LCP alto (imagens sem lazy)
- Mobile: viewport meta presente (OK)
- Canonical: ausente (IMPORTANTE)
...
# A skill deu ao Claude um checklist de 20+ itens,
# formato de relatorio e criterios de prioridade.
Exemplo 3: Desenvolvimento — com skill instalada
# Com a skill de Node.js/Express instalada, o Claude:
# - Usa a estrutura de pastas padrao do projeto
# - Aplica validacao com Zod
# - Implementa tratamento de erros consistente
# - Segue o padrao de autenticacao do projeto
# - Cria testes automaticamente
Skills de marketing: o que esta incluido
O o Mega Bundle de skills para Claude Code faz parte do Mega Bundle com 748+ skills em 7 categorias. Cada skill foi escrita por profissionais com experiencia real, nao por geradores de conteudo.
Areas cobertas:
- Copywriting: headlines, paginas de vendas, emails, anuncios, scripts de video
- SEO: auditoria tecnica, pesquisa de keywords, otimizacao on-page, link building
- Google Ads: estrutura de campanhas, copy de anuncios, negativacao de keywords, lances
- Meta Ads: criativos, copys, estrutura de campanhas, publicos
- Email Marketing: sequencias, assuntos, segmentacao, automacoes
- Analytics: GTM, GA4, Meta Pixel, Conversions API, dashboards
- CRO: otimizacao de conversao, testes A/B, heatmaps, funis
Cada skill contem entre 500 e 3.000 palavras de instrucoes, frameworks, templates e exemplos. Nao sao prompts de uma linha — sao manuais completos que transformam o Claude em um especialista real da area.
Skills de dev: o que esta incluido
O o Mega Bundle com 748+ skills para Claude Code inclui 284 skills de desenvolvimento de plataformas e ferramentas reais, alem de 464+ skills de marketing, SEO, copywriting, social media e workflows.
Plataformas incluidas:
- Anthropic: Claude API, Agent SDK, integracao com tools
- Vercel: Next.js, deployment, Edge Functions, analytics
- Stripe: pagamentos, subscricoes, webhooks, Checkout
- Supabase: banco de dados, auth, storage, edge functions
- Google Cloud: Firebase, Cloud Functions, BigQuery
- Cloudflare: Workers, Pages, R2, DNS
- E mais de 40 outras plataformas
Quando voce instala essas skills, o Claude Code passa a conhecer a documentacao atualizada de cada plataforma. Em vez de gerar codigo generico, ele gera codigo que segue as melhores praticas e APIs atuais de cada ferramenta.
Proximo passo: instale skills e veja a diferenca
Voce ja sabe o basico. Agora imagine o Claude Code sabendo fazer tudo isso sozinho. E isso que as skills fazem. Acesso vitalicio, atualizacoes incluidas.
Ver o Mega Bundle — R$19Perguntas frequentes sobre skills no Claude Code
Nao. Skills sao arquivos de texto (.md) que voce copia para uma pasta no seu computador. O processo leva menos de 2 minutos e nao exige nenhum conhecimento de programacao. O Claude Code le esses arquivos automaticamente.
Sim. As skills funcionam com qualquer plano do Claude Code — gratuito, Pro ou Enterprise. O que muda entre planos e o limite de mensagens, nao a capacidade de usar skills. O mecanismo de deteccao de skills e o mesmo em todos os planos.
Prompts sao instrucoes avulsas que voce digita a cada conversa. Se fechar o terminal, perde tudo. Skills sao arquivos permanentes com frameworks completos, regras, templates e contexto especializado. O Claude carrega skills automaticamente quando detecta que sao relevantes para a sua sessao — sem voce copiar e colar nada. E a diferenca entre dar uma instrucao verbal e entregar um manual completo.