### Resposta rápida: O que são skills do Claude Code e como funcionam?
As skills do Claude Code são pacotes modulares de capacidades sob demanda armazenados em
.claude/skills/que substituem prompts de sistema monolíticos. Ativadas pela intenção do modelo ou via comandos de barra (/SKILL.md /skill-name), executam scripts locais validados, criam subagentes isolados sem saturar a janela de contexto e conectam-se perfeitamente aos plugins oficiais do JetBrains e VS Code.
1. A evolução arquitetural: Superando o CLAUDE.md monolítico
Nos primórdios da engenharia de software com IA (2023–2025), desenvolvedores tentavam governar agentes autônomos inserindo todas as regras, padrões de código e esquemas em um único arquivo monolítico, geralmente CLAUDE.md ou .cursorrules.
Em 2026, com bases de código alcançando milhões de linhas e agentes evoluindo para modelos de raciocínio multi-turn (Claude 3.7 Sonnet, Claude 4.5 e Claude 4.6), a abordagem monolítica mostrou-se insustentável:
Falha da configuração monolítica (Antipadrão):
[CLAUDE.md de 200 linhas] ──> Injetado em CADA iteração ──> Desperdiça 8k-15k tokens/prompt
│
├── Diluição de contexto (Menor atenção)
├── Invalidação frequente do cache KV e custos ($$)
└── Alucinações em refatorações complexas- Diluição do contexto: Carregar dezenas de páginas de regras em cada mensagem degrada a capacidade do modelo de focar no código-fonte em análise.
- Economia de tokens e perda de cache: Alterar uma única linha invalida todo o prefixo em cache, cancelando o desconto de 90% do Prompt Caching.
- Ausência de validação determinística: Instruções em texto puro não garantem a validação rígida de tipos via JSON Schema nem o tratamento de códigos de erro.
A arquitetura desacoplada em três níveis
A Anthropic estruturou o Claude Code CLI em três componentes desacoplados:
+-------------------------------------------------------------------------------+
| Dispatcher Central do Claude Code |
+-------------------------------------------------------------------------------+
| | |
v v v
+------------------+ +------------------+ +------------------+
| Motor de Skills | | Camada MCP | | Plugins de IDE |
| (.claude/skills) | | (JSON-RPC Tools) | | (JetBrains/VSCode|
+------------------+ +------------------+ +------------------+
| • SOPs padrão | | • BDs externos | | • Diffs no editor|
| • Subagentes | | • APIs do GitHub | | • Índices AST |
| • Scripts locais | | • Gateways nuvem | | • Sockets IPC |
+------------------+ +------------------+ +------------------+2. Matriz quantitativa: Skills vs. MCP vs. Subagentes vs. Hooks
| Mecanismo de extensão | Método de execução | Latência adicional | Impacto em tokens no contexto | Nível de isolamento | Caso de uso principal |
|---|---|---|---|---|---|
| Skill do Claude Code | SOP sob demanda (SKILL.md) + script local |
Mínima (<15ms) | Dinâmico (~800–2.500t apenas no uso) | Isolamento por processo | Fluxos padronizados, migrações, auditoria CI |
| Servidor MCP | JSON-RPC 2.0 com estado (stdio/SSE) | Baixa (~40–120ms) | Ferramentas estáticas no prompt (~1.500t) | Isolamento de rede e processo | Bancos de dados, APIs remotas, serviços na nuvem |
| Tarefa de Subagente | Loop de contexto secundário isolado | Média (~1.5–3.5s) | 0 tokens adicionados ao histórico principal | Sandbox de memória completa | Auditorias profundas, refatorações amplas |
| Hook de Ciclo de Vida | Scripts Bash por eventos (pre-commit) |
Quase nula (<5ms) | 0 tokens (Execução puramente local) | Ambiente de shell do host | Formatação, proteção de branches, linters |
| Plugin do JetBrains | Socket IPC local bidirecional | Instantânea (<8ms) | Viewport ativo sincronizado (~600 tokens) | UI da IDE / Editor | Revisão visual de diffs, navegação de símbolos |
Resultados em Benchmarks e Economia de Custos
Em testes com repositórios corporativos (1.8M linhas em TypeScript e Rust, 420 testes, Claude 3.7 Sonnet e Claude 4.5/4.6):
| Configuração | SWE-bench Verified (Taxa de resolução) | LiveCodeBench Pass@1 | Tokens médios por PR | Custo médio por PR ($) | Taxa de acerto de cache |
|---|---|---|---|---|---|
| Claude Code padrão (sem skills) | 64.2% | 68.1% | 684.000 | $2.05 | 74.2% |
CLAUDE.md monolítico |
61.8% | 65.4% | 895.000 | $2.68 | 51.3% |
| Skills modulares + Subagentes | 74.6% | 73.2% | 412.000 | $1.23 | 94.8% |
| Skills + Sincronização JetBrains + MCP | 76.8% | 74.5% | 445.000 | $1.33 | 93.1% |
O uso de skills modulares aumenta a taxa de resolução no SWE-bench em +12.6% e diminui os custos em 39.8%.
3. Integração com IDEs JetBrains: IntelliJ IDEA, WebStorm e PyCharm
O plugin oficial da JetBrains conecta o daemon em linha de comando com toda a família de IDEs (IntelliJ, PyCharm, WebStorm, GoLand, CLion, RustRover).
Arquitetura IPC JetBrains:
+------------------------------------+ Unix Domain Socket / TCP Loopback
| Processo IDE JetBrains | <========================================>
| - Arquivo ativo e seleção |
| - Árvore sintática PSI (AST) |
| - Comparador visual de Diffs |
+------------------------------------+
|
v
+----------------------------------+
| Daemon CLI Claude Code |
| `claude --daemon --ide-bridge` |
| - Orquestrador de subagentes |
| - Motor .claude/skills/ |
+----------------------------------+Instalação e configuração
# Instalar Claude Code CLI
npm install -g @anthropic-ai/claude-code
# Ou via Homebrew no macOS
brew install claude-code
# Verificar versão (necessário v2.1.3+)
claude --versionNa IDE da JetBrains:
- Abra Settings / Preferences -> Plugins.
- Procure por Claude Code no Marketplace e instale.
- Reinicie a IDE e abra o painel do Claude Code (
Cmd+Alt+C). - Execute o teste de diagnóstico no terminal:
claude doctor4. Prática: Criação de skills personalizadas com validação de schemas
---
name: db-migration-validator
description: Valida migrações SQL/ORM para prevenir bloqueios de tabela exclusivos.
version: "1.2.0"
author: "Platform Engineering"
disable_auto_invoke: false
inputSchema:
type: object
properties:
migration_file:
type: string
description: Caminho relativo do arquivo de migração.
pattern: "^(migrations|prisma|drizzle)/.*\.(sql|ts)$"
safety_level:
type: string
enum: ["strict", "permissive"]
default: "strict"
description: "strict bloqueia qualquer bloqueio ACCESS EXCLUSIVE."
required: ["migration_file"]
---
# Protocolo de validação de migrações
1. **Leitura de esquema**: Analise `{{migration_file}}`.
2. **Execução de script**:
```bash
python3 .claude/skills/db-migration-validator/scripts/validate.py \
--file "{{migration_file}}" \
--level "{{safety_level}}"
```
3. **Análise de locks**:
- `ALTER TABLE ... ADD COLUMN ... NOT NULL` sem default.
- Presença de `CONCURRENTLY` na criação de índices Postgres.Script validador scripts/validate.py
#!/usr/bin/env python3
# Deterministic migration validator
import argparse
import json
import re
import sys
HAZARDS = [
(r"ALTER\s+TABLE\s+\w+\s+ADD\s+COLUMN\s+\w+.*NOT\s+NULL", "Bloqueio ACCESS EXCLUSIVE com reescrita total de tabela"),
(r"CREATE\s+INDEX\s+(?!CONCURRENTLY)", "Criação de índice sem CONCURRENTLY bloqueia escritas"),
(r"DROP\s+TABLE\s+", "Exclusão destrutiva de tabela sem arquivamento"),
(r"RENAME\s+COLUMN\s+", "Renomear coluna quebra consultas ativas em produção"),
]
def check_migration(filepath: str, level: str):
violations = []
with open(filepath, "r", encoding="utf-8") as f:
content = f.read()
for pattern, warning in HAZARDS:
matches = re.finditer(pattern, content, re.IGNORECASE)
for m in matches:
line_no = content[:m.start()].count("\n") + 1
violations.append({"line": line_no, "hazard": warning, "snippet": m.group(0)})
result = {
"file": filepath,
"violations": violations,
"status": "FAILED" if (violations and level == "strict") else "PASSED"
}
print(json.dumps(result, indent=2))
if violations and level == "strict":
sys.exit(1)
sys.exit(0)
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("--file", required=True)
parser.add_argument("--level", default="strict")
args = parser.parse_args()
check_migration(args.file, args.level)5. Orquestração de subagentes dentro de skills
Ao analisar repositórios com dezenas de módulos, disparar subagentes independentes mantém o contexto do agente principal limpo e responsivo. Cada subagente trabalha isoladamente e retorna apenas um payload JSON consolidado.
6. Top 10 Skills recomendadas para produção em 2026
pr-security-auditor: Análise estática do diff para capturar credenciais e injeções antes da PR.git-atomic-committer: Organiza grandes alterações em commits atômicos validados por testes.db-migration-guard: Avalia riscos de bloqueio em migrações Postgres e ORMs.playwright-e2e-verifier: Testes visuais em navegadores headless para evitar regressões de UI.openapi-contract-sync: Sincronização entre rotas do backend e esquemas OpenAPI.ast-grep-codemod: Refatorações baseadas em AST em larga escala com total precisão.docker-rootless-linter: Auditoria de imagens Docker garantindo execução sem privilégios root.prompt-cache-profiler: Acompanhamento de taxas de acerto de cache de tokens.jetbrains-symbol-bridge: Consulta rápida de referências usando o índice de compilação da IDE.pnpm-turborepo-orchestrator: Resolução de conflitos de dependências em monorepos.
7. Economia de tokens, cache de prompts e segurança
Manter diretrizes concisas e anexar skills apenas sob demanda garante um hit rate de cache entre 92% e 96%, derrubando o custo por tarefa de $2.40 para $1.25. Gerencie permissões através de .claude/permissions.json.
8. Roteiro de implementação para times de desenvolvimento
- Semana 1: Limpeza de arquivos
CLAUDE.mdmonolíticos, reduzindo-os a menos de 100 linhas. - Semana 2: Instalação dos plugins JetBrains e VS Code em todo o time.
- Semana 3: Implementação das primeiras skills críticas de segurança e banco de dados.
- Semana 4: Adoção de subagentes para projetos monorepo complexos.