LS
Claude Code

5 skills para gastar menos tokens no Claude Code

Use essas skills para reduzir contexto desnecessário, limpar sessões longas e manter o Claude focado no que realmente importa.

O Claude Code fica mais caro e menos eficiente quando uma sessão acumula tentativas antigas, respostas longas, saídas de ferramentas e decisões que já não importam mais. Essas 5 skills ajudam a controlar esse contexto ao longo do trabalho.

/doctor

Diagnostique para onde seus tokens estão indo

ObjetivoDescobrir o que está consumindo contexto antes de sair apagando ou alterando coisas sem necessidade.

O /doctor deve ser usado antes de você tentar otimizar uma sessão.

Ele funciona como um diagnóstico do contexto atual e ajuda a identificar quais arquivos, skills, instruções ou históricos estão ocupando espaço demais.

Quando usar
  • Quando a sessão começa a ficar cara
  • Quando o Claude parece mais lento ou confuso
  • Quando você adicionou muitas skills
  • Quando há muitos arquivos de contexto carregados
  • Antes de começar uma otimização maior
O que observar
  • Tamanho do contexto
  • Arquivos muito grandes
  • Skills que ficam sempre carregadas
  • Instruções repetidas
  • Histórico desnecessário
Como usar
/doctor

Execute o comando e analise os maiores consumidores de contexto. Procure especialmente por documentação extensa, exemplos desnecessários, histórico acumulado e instruções duplicadas.

Antes

“Eu acho que o Claude está gastando muitos tokens, mas não sei por quê.”

Depois

“Sei quais elementos estão ocupando mais contexto e onde otimizar.”

Resultado esperado

Você passa a saber exatamente onde estão os maiores gastos de contexto e consegue decidir o que vale a pena reduzir.

Ponytail

Faça o Claude responder com menos código e menos explicação

ObjetivoReceber respostas menores sem perder o que é necessário para continuar trabalhando.

Ponytail é útil quando o Claude entrega respostas muito maiores do que você realmente precisa.

Ela reduz explicações longas, comentários redundantes, código desnecessário e respostas excessivamente verbosas.

Quando usar
  • Quando o Claude gera arquivos inteiros sem necessidade
  • Quando explica demais antes de mostrar a solução
  • Quando repete o contexto
  • Quando adiciona comentários óbvios no código
  • Quando você já sabe o que está fazendo e quer apenas a execução
Como usar

A skill deve orientar o Claude a priorizar código necessário, explicações curtas, mudanças pontuais e respostas objetivas.

Peça somente o diff, a alteração necessária ou o trecho relevante sempre que possível.

Antes

“Vou explicar primeiro como funciona a arquitetura, depois mostrar três alternativas e, por fim, gerar o arquivo completo…”

Depois

“Altere estas 3 funções: 1. … 2. … 3. …”

Resultado esperado
  • Menos tokens por resposta
  • Menos tempo lendo
  • Revisão mais rápida
  • Menos contexto entrando no histórico
/rewind

Volte antes de uma abordagem que deu errado

ObjetivoEvitar carregar uma sequência inteira de correções desnecessárias.

Um erro comum em sessões longas é continuar corrigindo uma abordagem ruim por várias mensagens.

Mesmo depois de corrigida, toda aquela tentativa errada continua fazendo parte do histórico. O /rewind serve para voltar ao ponto anterior ao erro e continuar dali.

Quando usar
  • Quando o Claude escolheu uma arquitetura errada
  • Quando alterou o arquivo errado
  • Quando entendeu errado a tarefa
  • Quando você precisou gastar várias mensagens corrigindo a direção
  • Quando percebeu que seria mais fácil voltar e tentar de novo
Como usar
/rewind

Volte até a última resposta ou etapa em que o projeto ainda estava no caminho certo. A partir dali, forneça a instrução correta e continue.

Como costuma acontecer
  1. ÚLTIMO ESTADO BOM
  2. ABORDAGEM ERRADA
  3. CORREÇÃO
  4. CORREÇÃO
  5. CORREÇÃO
Com a skill
  1. ÚLTIMO ESTADO BOM
  2. /rewind
  3. NOVA ABORDAGEM
Resultado esperado
  • Menos histórico inútil
  • Menos mensagens de correção
  • Contexto mais coerente
  • Menor chance do Claude reutilizar uma decisão errada

AtençãoNão use rewind se as mensagens posteriores contiverem decisões importantes que você ainda precisa preservar.

/compact

Compacte sessões longas sem perder o progresso

ObjetivoManter as informações importantes e reduzir o peso do histórico antigo.

Ao trabalhar por muito tempo na mesma sessão, o histórico cresce continuamente.

O /compact transforma o estado atual da conversa em uma versão condensada do que realmente importa.

Quando usar
  • Depois de várias horas na mesma sessão
  • Após concluir uma etapa grande do projeto
  • Antes de iniciar uma nova feature
  • Quando o contexto já está muito ocupado
  • Quando o Claude começa a trazer assuntos antigos para tarefas novas
O checkpoint deve preservar
  • Objetivo do projeto
  • Decisões tomadas
  • Arquitetura atual
  • Arquivos importantes
  • Mudanças já realizadas
  • Bugs ainda abertos
  • Próximos passos
  • Restrições importantes
Evitar preservar
  • Conversas repetidas
  • Tentativas que falharam
  • Explicações antigas
  • Logs irrelevantes
  • Saídas de ferramentas já utilizadas
Como usar
/compact

Peça para condensar o estado da sessão em um checkpoint contendo apenas aquilo que é necessário para continuar.

Como costuma acontecer
  1. Histórico
  2. Mensagens
  3. Tentativas
  4. Logs
  5. Explicações
  6. Código antigo
Com a skill
  1. Objetivo
  2. Estado atual
  3. Decisões
  4. Próximos passos
Resultado esperado

Uma sessão mais leve e focada, sem perder o contexto necessário para continuar.

AtençãoRevise o checkpoint antes de seguir para garantir que nenhuma decisão essencial foi removida.

/handoff

Leve o progresso para uma sessão nova e limpa

ObjetivoComeçar uma sessão limpa sem precisar explicar todo o projeto novamente.

Em algum momento, mesmo uma sessão compactada pode deixar de ser a melhor opção.

O /handoff cria um resumo estruturado do estado atual para você iniciar uma nova sessão sem carregar toda a conversa anterior.

Quando usar
  • No início de um novo dia de trabalho
  • Ao trocar de feature
  • Quando uma sessão ficou longa demais
  • Quando /compact já não é suficiente
  • Antes de mudar de máquina, ambiente ou agente
  • Quando você quer uma nova janela de contexto
O que o handoff deve conter
  • Objetivo
  • Estado atual
  • O que já foi concluído
  • Decisões técnicas importantes
  • Arquivos relevantes
  • Problemas em aberto
  • Restrições
  • Próximos passos
Como usar
/handoff

O handoff deve gerar um arquivo ou bloco estruturado com o estado do projeto.

Exemplo de estrutura

# Handoff

## Objetivo
Implementar autenticação…

## Estado atual
Login concluído…

## Decisões
- usar Supabase Auth
- manter middleware…

## Próximos passos
1. proteger dashboard
2. adicionar logout
3. testar sessão expirada
Como costuma acontecer
  1. SESSÃO ANTIGA
  2. /handoff
  3. RESUMO DO ESTADO ATUAL
Com a skill
  1. NOVA SESSÃO
  2. CONTINUAR DE ONDE PAROU
Resultado esperado
  • Janela de contexto limpa
  • Menos tokens herdados
  • Menos ruído
  • Continuidade do projeto
  • Respostas mais focadas
Como usar as 5 juntas

O fluxo ideal

Elas não são concorrentes. Cada uma resolve um momento diferente do trabalho.

  1. /doctor

    Diagnostique o contexto

  2. Ponytail

    Reduza respostas desnecessariamente grandes

  3. /rewind

    Apague caminhos errados

  4. /compact

    Condense sessões longas

  5. /handoff

    Comece uma sessão limpa

Um dia de trabalho

Você começou a trabalhar às 9h.

10h
Rode /doctor para entender o contexto.
Durante o trabalho
Use Ponytail para manter respostas curtas.
Se o Claude seguir uma direção errada
Use /rewind.
Depois de algumas horas
Use /compact.
Ao terminar o dia ou iniciar uma nova fase
Use /handoff e continue em uma sessão nova.
O princípio

Menos contexto não significa menos informação.

O objetivo não é remover informação importante. É remover informação que não ajuda mais o Claude a tomar a próxima decisão.

Mantenha
  • Objetivo
  • Estado atual
  • Decisões
  • Restrições
  • Próximos passos
Remova
  • Tentativas antigas
  • Erros já resolvidos
  • Explicações repetidas
  • Logs que já cumpriram seu papel
  • Contexto que não influencia mais a tarefa
Boas práticas

Para o dia a dia

  • Prefira sessões com objetivos claros
  • Evite misturar tarefas muito diferentes na mesma conversa
  • Não envie arquivos gigantes sem necessidade
  • Reduza instruções duplicadas
  • Mantenha documentação útil, não toda documentação
  • Crie checkpoints entre etapas grandes
  • Abra uma sessão nova quando o contexto antigo deixar de ajudar
  • Sempre revise um compact ou handoff importante antes de continuar
Para levar

Agora coloque isso no seu fluxo.

Você não precisa usar todas as skills o tempo inteiro. Use cada uma quando o problema aparecer.

Resumo
/doctor
diagnosticar
Ponytail
reduzir
/rewind
corrigir caminho
/compact
condensar
/handoff
recomeçar limpo