PLAYBOOK EXECUTÁVEL · @herykrogues

Skills Nativas no Claude Code: Otimização de Contexto e Automação sob Demanda

Tire procedimentos repetíveis do arquivo permanente. O Claude descobre a capacidade agora — e só carrega as instruções completas quando a tarefa pedir.

Tempo: 2 min Nível: Prático / Terminal Custo: $0

Pegar a skill pronta Entender o mecanismo

01 · POR BAIXO DOS PANOS

Contexto só quando importa.

Em vez de carregar um manual inteiro em toda conversa, a skill libera contexto em três camadas.

CAMADA 1<100 tokens

Descoberta

Na inicialização, só name e description ficam visíveis.

CAMADA 2MATCH

Ativação dinâmica

O pedido combina com a descrição. Só então o corpo do SKILL.md entra.

CAMADA 3ON DEMAND

Execução sob demanda

Referências e scripts abrem apenas se forem necessários para concluir a tarefa.

02 · ARQUIVO PRONTO

Sua primeira skill, sem montar do zero.

Copie o arquivo abaixo. Ele transforma revisão de código em um procedimento repetível.

---
name: code-review
description: Use esta skill ao revisar código, pull requests ou diffs para encontrar bugs, riscos de segurança, regressões, problemas de desempenho e lacunas de testes.
---

# Revisão de código

Revise a mudança como código que será executado em produção.

## Processo

1. Leia o diff e identifique o comportamento que mudou.
2. Conecte a mudança ao código chamador e aos testes existentes.
3. Procure bugs, regressões, falhas de segurança e casos-limite.
4. Verifique se caminhos de risco têm testes relevantes.
5. Remova observações cosméticas que não afetam o resultado.

## Saída

- Liste primeiro os achados, do mais grave ao menos grave.
- Para cada achado, cite arquivo e linha, impacto e correção sugerida.
- Se não houver achados, diga isso claramente e cite riscos residuais.
- Não altere arquivos sem autorização explícita.

03 · INSTALAÇÃO GLOBAL

Uma linha. Todos os projetos.

Escolha seu terminal, copie e execute. A pasta pessoal deixa a skill disponível em qualquer projeto.

f=~/.claude/skills/code-review/SKILL.md; if [ -e "$f" ]; then printf '%s\n' 'Já existe ~/.claude/skills/code-review/SKILL.md — nada foi alterado.'; else mkdir -p ~/.claude/skills/code-review && printf '%s\n' '---' 'name: code-review' 'description: Use esta skill ao revisar código, pull requests ou diffs para encontrar bugs, riscos de segurança, regressões, problemas de desempenho e lacunas de testes.' '---' '' '# Revisão de código' '' 'Revise a mudança como código que será executado em produção.' '' '## Processo' '' '1. Leia o diff e identifique o comportamento que mudou.' '2. Conecte a mudança ao código chamador e aos testes existentes.' '3. Procure bugs, regressões, falhas de segurança e casos-limite.' '4. Verifique se caminhos de risco têm testes relevantes.' '5. Remova observações cosméticas que não afetam o resultado.' '' '## Saída' '' '- Liste primeiro os achados, do mais grave ao menos grave.' '- Para cada achado, cite arquivo e linha, impacto e correção sugerida.' '- Se não houver achados, diga isso claramente e cite riscos residuais.' '- Não altere arquivos sem autorização explícita.' > "$f"; fi

$p = Join-Path $HOME '.claude\skills\code-review'; $f = Join-Path $p 'SKILL.md'; if (Test-Path -LiteralPath $f) { Write-Warning 'Já existe ~/.claude/skills/code-review/SKILL.md — nada foi alterado.' } else { New-Item -ItemType Directory -Force -Path $p | Out-Null; $c = @('---','name: code-review','description: Use esta skill ao revisar código, pull requests ou diffs para encontrar bugs, riscos de segurança, regressões, problemas de desempenho e lacunas de testes.','---','','# Revisão de código','','Revise a mudança como código que será executado em produção.','','## Processo','','1. Leia o diff e identifique o comportamento que mudou.','2. Conecte a mudança ao código chamador e aos testes existentes.','3. Procure bugs, regressões, falhas de segurança e casos-limite.','4. Verifique se caminhos de risco têm testes relevantes.','5. Remova observações cosméticas que não afetam o resultado.','','## Saída','','- Liste primeiro os achados, do mais grave ao menos grave.','- Para cada achado, cite arquivo e linha, impacto e correção sugerida.','- Se não houver achados, diga isso claramente e cite riscos residuais.','- Não altere arquivos sem autorização explícita.') -join [Environment]::NewLine; Set-Content -LiteralPath $f -Value $c -Encoding utf8 }

~/.claude/skills/code-review/SKILL.md● pronta em qualquer projeto

04 · ANTES DE RODAR

Onde quebra & boas práticas

Leia antes de instalar

Skills são instruções executáveis. Revise arquivos de terceiros, scripts e referências antes de colocar qualquer coisa na pasta pessoal.

Escolha o escopo certo

Use ~/.claude/skills/ para rotinas pessoais em todos os projetos. Use ./.claude/skills/ quando a regra pertence só ao repositório.

YAML não perdoa

Mantenha name e description no frontmatter, entre as linhas ---. Espaços e delimitadores errados impedem a descoberta.

PRÓXIMA EXECUÇÃO

Do README ao resultado.

Skills abertas, agentes no terminal e playbooks que você consegue aplicar hoje.

Acompanhar @herykrogues