Você instalou o Claude Code. Agora vem a parte que muda tudo.
O Claude Code sem skills é um engenheiro sênior no primeiro dia de trabalho: brilhante, mas sem o contexto do projeto que o tornaria verdadeiramente perigoso.
Toda vez que você abre uma nova sessão, precisa re-explicar suas convenções de código, como prefere os commits, que stack está usando, quais padrões deve seguir. É o equivalente a contratar um funcionário de altíssimo nível e refazê-lo do zero toda segunda-feira.
Skills resolvem exatamente isso.
Em outubro de 2025, a Anthropic lançou oficialmente o sistema de Skills para o Claude Code. Em menos de seis meses, o ecossistema explodiu: mais de 789 skills catalogadas no Claude Skills Hub, 1.234 skills no repositório da comunidade antigravity-awesome-skills (22.000+ GitHub stars), e uma divisão cada vez mais clara entre desenvolvedores que usam skills e os que ainda estão brigando com contexto.
Este guia vai te colocar no primeiro grupo.
O que são Skills do Claude Code — a definição que importa
Uma Skill é um arquivo Markdown (.md) que fica na pasta ~/.claude/skills/ da sua máquina. Quando você faz um request ao Claude Code, ele lê o nome e a descrição de cada skill instalada e decide automaticamente quais são relevantes para aquela tarefa — sem você precisar invocar manualmente.
A mágica técnica é simples: skills carregam instruções especializadas no contexto do modelo somente quando necessárias. Isso preserva a janela de contexto para o que realmente importa e evita o fenômeno de "fadiga de instrução" — quando o modelo tem tantas regras conflitantes que começa a ignorar todas.
Estrutura de Skills no Claude Code — arquivos SKILL.md organizados por categoria em ~/.claude/skills/
Skills são um padrão aberto
O formato SKILL.md foi adotado como padrão aberto pelo ecossistema de agentes de IA. A mesma skill que você instala no Claude Code funciona sem modificação no:
- OpenAI Codex CLI
- Cursor
- Gemini CLI
- GitHub Copilot
- Google Antigravity IDE
- OpenCode
Você escreve uma vez, usa em todos os seus ambientes.
Os dois tipos de Skills que existem — e por que a distinção importa
Antes de instalar qualquer coisa, entenda esta divisão fundamental documentada por Nate Herk:
Capability Uplift — Claude ganha habilidades que não tinha
São skills que ensinam ao Claude Code coisas que ele genuinamente não consegue fazer sem elas. Scraping de web com Firecrawl, criação de PDFs reais, testes browser com Playwright, integração com APIs externas. Sem a skill, a tarefa falha. Com a skill, funciona.
Essas são as skills com maior ROI. Se o seu fluxo de trabalho envolve qualquer uma dessas capacidades, instalar a skill é decisão óbvia.
Encoded Preference — Claude já sabe fazer, agora faz do seu jeito
São skills que ensinam convenções, padrões e preferências. Claude já sabe escrever código frontend — mas sem a skill frontend-design, vai entregar o visual genérico de sempre: Inter font, gradiente roxo em branco, grid cards. Com a skill, gera estética distinctive.
Essas são mais pessoais: o que melhora para um desenvolvedor pode piorar para outro. Escolha com critério.
Como instalar Skills em 2 minutos
Estrutura de pastas
# Skills pessoais (disponíveis em todos os projetos)
~/.claude/skills/
# Skills do projeto (disponíveis só neste repositório)
.claude/skills/
Método 1 — Instalação manual (mais simples)
# Criar pasta de skills se não existir
mkdir -p ~/.claude/skills
# Baixar uma skill específica
curl -o ~/.claude/skills/frontend-design.md \
https://raw.githubusercontent.com/anthropics/claude-code-skills/main/frontend-design/SKILL.md
# Verificar skills instaladas dentro do Claude Code
/skills
Método 2 — Biblioteca da comunidade com npm (recomendado)
# Instalar skill do repositório antigravity-awesome-skills
npx antigravity-awesome-skills --claude security-auditor
npx antigravity-awesome-skills --claude frontend-design
npx antigravity-awesome-skills --claude systematic-debugging
# Instalar bundle completo de desenvolvimento
npx antigravity-awesome-skills --claude --bundle core-dev
# Buscar skills por tema
npx antigravity-awesome-skills search seo
npx antigravity-awesome-skills search security
Método 3 — Claude Skills Hub (interface visual)
Acesse clskills.in/browse, encontre a skill que quer, clique em Download e mova o arquivo .md para ~/.claude/skills/. São 789+ skills gratuitas e open source.
Invocar uma skill manualmente
No chat do Claude Code /frontend-design /security-review /simplify Verificar todas as skills disponíveis /skills
As 12 melhores Skills do Claude Code em abril de 2026
1. frontend-design ⭐ — 277.000 instalações
Tipo: Encoded Preference Instalações: 277.000+ (oficial Anthropic)
A skill mais instalada do ecossistema. Resolve o problema que toda IA de código tem: gerar o mesmo visual genérico toda vez. A frontend-design fornece ao Claude um sistema de design com filosofia estética antes de qualquer código — tipografia bold, paleta com propósito, animações intencionais.
npx antigravity-awesome-skills --claude frontend-design
Resultado prático: UIs que não parecem geradas por IA. O mesmo agente, outputs radicalmente diferentes.
2. systematic-debugging ⭐ — essencial para qualquer dev
Tipo: Encoded Preference Fonte: Comunidade
O comportamento padrão do Claude ao encontrar um bug é aleatório: modifica variável, adiciona log, comenta bloco, reverte, tenta outra coisa. Sem hipótese, sem isolamento, sem método. Destrutivo.
A systematic-debugging codifica um protocolo de quatro etapas que o modelo não pode pular:
- Reproduzir o bug com o menor caso de teste possível
- Formular uma hipótese precisa e única sobre a causa
- Testar apenas essa hipótese
- Observar, documentar, iterar
npx antigravity-awesome-skills --claude systematic-debugging
Uma das skills com maior impacto na qualidade do código produzido.
3. superpowers ⭐ — workflow completo de desenvolvimento
Tipo: Encoded Preference + Capability Uplift Fonte: obra (via plugin marketplace)
Uma das skills mais ambiciosas da comunidade. Em vez de jogar o Claude diretamente no código, ela guia por um fluxo estruturado completo: brainstorm → design spec → implementation plan → subagent execution → review → merge
# Via plugin marketplace do Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Inclui sub-skills específicas: brainstorming (refinamento de ideias via perguntas Socráticas), using-git-worktrees (branch e workspace isolados antes de qualquer código), lint-and-validate (verificação antes do merge).
4. security-auditor — auditoria que outros não fazem
Tipo: Capability Uplift Fonte: Comunidade (zebbern/security-suite)
A skill mais completa de segurança para 2026. Cobre o que ferramentas tradicionais não veem:
- Prompt injection em pipelines de agentes
- Data exfiltration via MCP tools comprometidas
- Privilege escalation em arquiteturas multi-agente
- SQL injection, XSS, endpoints sem autenticação
- CVEs em dependências do projeto
npx antigravity-awesome-skills --claude security-auditor
Ativa automaticamente quando você faz /review ou menciona "segurança", "auditoria" ou "vulnerabilidade".
5. claude-seo — sistema completo com 13 sub-skills
Tipo: Capability Uplift Fonte: Comunidade
Não é um prompt de "escreva um artigo SEO". É um sistema com 13 sub-skills e 7 subagentes paralelos cobrindo:
- SEO técnico (estrutura de headings, schema markup, Core Web Vitals)
- E-E-A-T analysis de conteúdo
- GEO (Generative Engine Optimization) — aparecer nas respostas do ChatGPT, Perplexity e Google AI Overviews
- AEO (Answer Engine Optimization) — ser a fonte citada por esses sistemas
npx antigravity-awesome-skills --claude claude-seo
Para criadores de conteúdo e agências, esta é provavelmente a skill com maior ROI imediato.
6. firecrawl — web scraping que realmente funciona
Tipo: Capability Uplift Fonte: Firecrawl (oficial)
Sem skills de scraping, o Claude Code tenta acessar URLs com fetch e falha em 80% dos casos — login walls, JavaScript dinâmico, proteções anti-bot. Com a skill Firecrawl, ele usa a infraestrutura real de scraping:
- Páginas com JavaScript pesado
- Sites com autenticação
- Extração de tabelas, PDFs e documentos
- Monitoramento de mudanças em páginas
npx antigravity-awesome-skills --claude firecrawl
Combinada com pesquisa e geração de relatórios, muda completamente o que um agente consegue fazer com dados da web.
7. web-design-guidelines — 133.400 instalações semanais
Tipo: Encoded Preference Instalações: 133.400+ semanais Fonte: Vercel Labs
Busca as guidelines mais recentes de vercel-labs/web-interface-guidelines e valida seus arquivos contra todos os padrões definidos, retornando violações em formato file:line:
npx antigravity-awesome-skills --claude web-design-guidelines
O diferencial: sempre usa a versão mais atual das guidelines, sem depender de conhecimento estático do modelo. Integra bem em pipelines de CI para validação automática antes de PR.
8. remotion-best-practices — 117.000 instalações semanais
Tipo: Capability Uplift Instalações: 117.000 semanais Fonte: Remotion (oficial)
Para quem trabalha com vídeo programático em React. A skill codifica expertise completa do framework Remotion:
- Animações, easing, spring animations, sequências
- Áudio e legendas (Mediabunny)
- Vídeo 3D via Three.js e React Three Fiber
- Charts e visualização de dados
- Schemas parametrizáveis com Zod
npx antigravity-awesome-skills --claude remotion-best-practices
Ativa automaticamente quando Claude detecta código Remotion no contexto.
9. agent-sandbox-skill — código em sandbox isolado
Tipo: Capability Uplift Fonte: E2B (oficial)
Dá ao Claude Code um sandbox cloud completo para executar código sem tocar no filesystem local nem em produção. Cada fork do agente tem um ambiente independente:
npx antigravity-awesome-skills --claude agent-sandbox-skill
Essencial para: rodar código não confiável, instalar packages sem poluir o ambiente local, testar deploys e servers com segurança. Compatível com Claude Code, Gemini CLI e Codex CLI.
10. context-engineering — para quem constrói sistemas multi-agente
Tipo: Encoded Preference Fonte: Comunidade
Context engineering — decidir exatamente o que um modelo deve e não deve ver — virou disciplina essencial em 2026. Essa skill endereça problemas concretos:
- Como evitar colisões de instrução quando múltiplas skills estão ativas
- Como estruturar memória de agentes em workflows longos
- Como otimizar uso do context window em pipelines de subagentes
- Como fazer routing entre agentes sem degradar a qualidade
npx antigravity-awesome-skills --claude context-engineering
Para desenvolvedores que constroem mais do que usam agentes.
11. gws (Google Workspace CLI) — integração total com Google
Tipo: Capability Uplift Fonte: Google (oficial, março 2026) Stars: 4.900 em 3 dias
O Google lançou o gws em março de 2026 — uma CLI que expõe todas as APIs do Google Workspace via servidor MCP integrado. Um comando e seu agente tem acesso completo:
npm install -g @googleworkspace/cli
# Iniciar servidor MCP com APIs selecionadas
gws mcp -s drive,gmail,calendar,sheets
# Instalar skill correspondente
npx skills add https://github.com/googleworkspace/cli
Qualquer workflow que envolva copiar entre Gmail, Drive, Sheets e Calendar pode virar automação completa.
12. claude-marketing — copywriting e estratégia em escala
Tipo: Encoded Preference + Capability Uplift Fonte: Comunidade
Bundle de skills especializadas em marketing:
- Copywriting com framework de conversão
- CRO (Conversion Rate Optimization) para landing pages
- SEO de conteúdo e análise de intent
- Sequências de email
- Ad copy para Google e Meta
- Funnel analysis
O modelo detecta automaticamente qual sub-skill ativar baseado no request — você não precisa gerenciar o roteamento.
As Skills builtin do Claude Code que você provavelmente está ignorando
Antes de instalar skills da comunidade, verifique o que já vem de fábrica:
| Skill | Invocação | O que faz |
|---|---|---|
| simplify | /simplify | Revisa código recente com 3 agentes paralelos — qualidade, reutilização, eficiência |
| review | /review | Code review completo com classificação crítico/médio/baixo |
| debug | /debug [erro] | Debug sistemático do erro especificado |
| batch | /batch | Executa múltiplas tasks independentes em paralelo |
| loop | /loop | Repete uma task até critério de qualidade ser atingido |
| claude-api | /claude-api | Referência da API da Anthropic no contexto |
O /simplify em particular é subestimado — roda 3 agentes de revisão em paralelo e entrega um mini code review automático após qualquer refatoração.
O que não fazer ao instalar skills
Não instale tudo de uma vez. Cada skill adiciona metadados ao contexto do modelo. Muitas skills aumentam tokens, criam ruído e podem ativar skills erradas. O desenvolvedor testou 47 skills de um repositório famoso — 40 pioraram o output.
Mantenha skills abaixo de 2.000 tokens. Segundo o guia oficial da Anthropic, skills mais curtas performam melhor. Instruções longas diluem o foco.
Skills não são garantia. O modelo decide probabilisticamente qual skill ativar com base no seu request. Se a skill não dispara, tente invocar explicitamente com /nome-da-skill ou refine a description do arquivo SKILL.md.
Comece com 3-5 skills. Um starter pack funcional: frontend-design, systematic-debugging, security-auditor, web-design-guidelines e uma skill de git como smart-commit. Adicione conforme a necessidade real aparece.
Como criar sua própria Skill em 5 minutos
A melhor skill que você vai instalar é frequentemente a que você mesmo criou. Estrutura básica:
# Criar pasta para a skill
mkdir -p ~/.claude/skills/meu-projeto-conventions
# Criar o arquivo SKILL.md
nano ~/.claude/skills/meu-projeto-conventions/SKILL.md
---
name: meu-projeto-conventions
description: >
Use when working on any code in this project.
Enforces our stack conventions: Next.js App Router,
Supabase, Tailwind, TypeScript strict mode.
Do NOT use for non-project files or general questions.
---
## Stack
- Next.js 16 App Router — Server Components por padrão
- Supabase — RLS obrigatório em todas as tabelas
- Tailwind CSS — sem CSS inline, sem styled-components
- TypeScript strict — sem `any`, sem `// @ts-ignore`
## Commits
Usar Conventional Commits: feat/fix/chore/docs/refactor
Scope obrigatório: feat(auth): add OAuth login
## Antes de qualquer PR
- [ ] `npm run build` passou sem erros
- [ ] Nenhuma tabela Supabase sem RLS
- [ ] Tipos TypeScript atualizados com `supabase gen types`
Salve, reinicie o Claude Code, e ele vai seguir suas convenções automaticamente em todo request relacionado ao projeto.
Skills vs CLAUDE.md — quando usar cada um
Uma dúvida comum: usar Skills ou colocar tudo no CLAUDE.md?
CLAUDE.md: Sempre carregado, sem overhead de ativação. Ideal para contexto global do projeto — stack, regras absolutas, informações que devem estar sempre presentes.
Skills: Carregadas sob demanda. Ideal para capacidades especializadas que só fazem sentido em contextos específicos — debugging, design, SEO, segurança. Não polui o contexto quando não são relevantes.
A resposta certa em 2026: use os dois. CLAUDE.md para regras do projeto, Skills para capacidades especializadas.
Como o Zently usa a mesma lógica de especialização
O conceito por trás das Skills do Claude Code — um agente genérico que fica especialista quando o contexto pede — é exatamente o que o Zently aplica no atendimento ao WhatsApp.
Enquanto o Claude Code ativa a skill systematic-debugging quando encontra um erro, o Zently ativa o agente de qualificação quando detecta intenção de compra, o agente de agendamento quando o cliente quer marcar horário, e o agente de suporte quando há um problema.
O resultado: atendimento que parece com um especialista humano que conhece profundamente seu negócio — não um bot genérico.
Quer ver como funciona? Acesse zently.com.br e configure em 15 minutos.
Para quem usa o Google Antigravity, as mesmas skills funcionam nele também — o formato SKILL.md é o padrão aberto do ecossistema. E para usar LLMs gratuitas no OpenCode + Antigravity com as mesmas skills, o fluxo de instalação é idêntico.
Conclusão
O ecossistema de Skills do Claude Code em abril de 2026 chegou num ponto de maturidade que justifica investimento real de tempo. Não de hype — de experimentação prática.
A distinção entre Capability Uplift (o agente ganha habilidades novas) e Encoded Preference (o agente faz do seu jeito) muda como você escolhe o que instalar. A regra é simples: Skills de Capability Uplift primeiro, porque o ROI é óbvio. Skills de preferência com critério, porque o que melhora para um dev pode piorar para outro.
Comece com o starter pack: frontend-design, systematic-debugging, security-auditor e um arquivo SKILL.md customizado para o seu projeto. Uma semana de uso real vai mostrar exatamente quais você precisa — e quais são hype sem substância.
npm install -g @anthropic-ai/claude-code e /skills para começar.
