context-budget

Visão geral da skill context-budget

O que a skill context-budget faz

A skill context-budget audita quanto do contexto da sessão no Claude Code está sendo consumido por agents, skills, rules e servidores MCP. A proposta é simples: identificar onde os tokens estão sendo gastos, estimar o que realmente pesa e transformar isso em ações de limpeza priorizadas, em vez de sugestões vagas como “reduza o tamanho do prompt”.

Quem deve instalar a context-budget

Esta skill é mais indicada para quem mantém uma configuração de Claude Code que já não é trivial: vários agents personalizados, uma pasta skills/ em crescimento, arquivos de rules em camadas ou diversos servidores MCP. Se as suas sessões parecem mais lentas, as respostas perderam consistência ou você não sabe se adicionar mais uma ferramenta vai prejudicar a qualidade, a context-budget tende a encaixar bem. Para setups mínimos, com poucos arquivos, ela costuma ser menos útil.

Por que escolher a context-budget em vez de um prompt genérico

Um prompt genérico de auditoria pode pedir ao modelo para “procurar inchaço”, mas a context-budget entrega um fluxo estruturado: inventariar componentes, estimar carga de tokens, sinalizar gargalos comuns, evitar contagem duplicada de skills copiadas e gerar oportunidades de economia ranqueadas. Isso torna a skill context-budget especialmente útil para Skill Testing, porque reduz o achismo e cria um processo de revisão repetível.

Limites importantes antes de instalar

Esta é uma skill de estimativa e triagem, não um tokenizer com precisão absoluta nem uma ferramenta de refatoração automática. Ela foca em sinais práticos de sobrecarga, como arquivos grandes demais, frontmatter excessivamente verboso, rules sobrepostas e servidores MCP com muitas tools. Se você precisa de contabilidade exata de tokens em runtime, trate os números como direcionais e use-os para priorizar o que vale inspecionar manualmente.

Como usar a skill context-budget

Instale a context-budget no seu fluxo de skills

O repositório não expõe um pacote separado apenas para esta skill. Na prática, o usuário instala a partir do repositório principal e chama a skill context-budget de lá. Um ponto de partida comum é:

npx skills add affaan-m/everything-claude-code --skill context-budget

Depois, confirme se a skill aparece entre as suas skills instaladas e abra skills/context-budget/SKILL.md no repositório de origem se quiser entender o fluxo de auditoria pretendido antes de rodar.

Que tipo de entrada a skill context-budget precisa

A skill context-budget funciona melhor quando você a aponta para uma estrutura real de workspace do Claude Code. Entradas úteis incluem:

• agents/*.md
• skills/*/SKILL.md
• rules/**/*.md
• .mcp.json ou a configuração MCP ativa
• observações sobre quais componentes de fato são carregados nas sessões normais

Não peça apenas “audite meu contexto”. Melhor: “Audit token overhead across agents/, skills/, rules/, and .mcp.json. Estimate heavy files, duplicated skills, overlapping rules, and MCP tool schema cost. Return top 5 savings ranked by impact vs effort.”

Como transformar um objetivo vago em um bom prompt para context-budget

Um prompt fraco pede um resumo genérico. Um bom uso da context-budget define escopo, formato de saída e critérios de decisão. Exemplo:

“Use the context-budget skill on this repo. Inventory all agents, skills, rules, and MCP servers. Estimate token consumption with clear assumptions, skip identical duplicated skills if mirrored under .agents/skills/, flag heavy files and redundant rule content, and recommend immediate, medium, and low-priority cuts. Include likely savings and risk of removing each item.”

Esse prompt melhora a qualidade porque obriga a skill a separar medição, deduplicação e priorização.

Melhor fluxo de trabalho e o que ler primeiro

Leia primeiro o SKILL.md; ele traz o método completo. Foque em:

1. When to Use
2. How It Works
3. Phase 1: Inventory
4. Phase 2 classification and recommendations

Na prática, o melhor fluxo é:

1. Rodar uma auditoria ampla.
2. Validar manualmente os maiores pontos de sobrecarga.
3. Remover ou consolidar uma categoria por vez.
4. Rodar novamente a skill context-budget após cada mudança.

Assim, você evita que uma limpeza grande demais quebre comportamentos úteis e, ao mesmo tempo, recupera margem de contexto com mais rapidez.

FAQ da skill context-budget

Vale a pena usar a context-budget em um setup pequeno?

Em geral, não. Se você tem poucas skills e não há proliferação de MCP, uma inspeção comum costuma bastar. A skill context-budget passa a ter mais valor quando o seu ambiente ganha peças o suficiente para que a sobrecarga oculta afete a qualidade ou torne arriscadas futuras adições.

Em que a context-budget difere de um prompt comum de revisão de repositório?

Um prompt comum costuma revisar a qualidade do conteúdo; a context-budget revisa o custo de contexto. Ela é ajustada para fontes de sobrecarga fáceis de deixar passar, como skills instaladas em duplicidade, descrições longas demais, rules sobrepostas e schemas de tools MCP volumosos. É por esse foco mais estreito que ela pode superar um pedido amplo como “otimize meu setup”.

Iniciantes podem usar a skill context-budget?

Sim, desde que consigam identificar os arquivos e pastas de configuração do Claude Code. Você não precisa ter conhecimento profundo de tokenização. O principal risco para iniciantes é apagar orientação útil demais ao ver alertas de “arquivo grande”. Use a skill para ranquear candidatos e depois inspecione os itens de maior impacto antes de removê-los.

Quando eu não devo usar a context-budget?

Evite usar se o seu problema for comportamento do modelo sem relação com carga de contexto, como instruções de tarefa fracas, exemplos ruins ou permissões ausentes. Também não é a escolha certa quando você precisa de matemática exata de tokenizer ou de edições automáticas; o guia da context-budget serve para diagnóstico e priorização, não para contabilidade precisa nem remediação com um clique.

Como melhorar a skill context-budget

Dê mais contexto do repositório e hipóteses realistas de carga ativa

A melhor forma de melhorar os resultados da context-budget é informar o que realmente é carregado nas sessões reais. Diferencie rules sempre ativas das que raramente são usadas, e servidores MCP ativos dos que estão configurados, mas ociosos. Sem isso, a skill pode superestimar componentes de baixo impacto e subestimar os gargalos de verdade.

Peça trade-offs ranqueados, não só contagens brutas

Estimativas brutas de tokens não bastam. Peça à skill context-budget para pontuar os achados por impacto, esforço e risco. Por exemplo: “Prefer recommendations that save meaningful context without removing unique capabilities.” Isso ajuda a evitar recomendações ruins, como apagar uma skill longa, mas essencial, antes de enxugar texto duplicado em rules.

Fique atento aos modos de falha mais comuns da context-budget

Os maiores modos de falha são contar em dobro arquivos espelhados, tratar todas as tools como se tivessem o mesmo custo e assumir que arquivos grandes são automaticamente desperdício. Peça à skill que separe:

• conteúdo duplicado vs. conteúdo único
• sobrecarga estática vs. contexto usado com frequência
• frontmatter inchado vs. instruções operacionais necessárias

Isso torna a saída mais pronta para decisão.

Rode a context-budget novamente após cada limpeza

Não acumule muitas edições de uma vez torcendo para dar certo. Use a skill context-budget de forma iterativa: auditar, alterar um grupo, auditar de novo, comparar. Isso mostra se a limpeza realmente abriu espaço útil de contexto ou apenas deslocou a complexidade para outro lugar. Para Skill Testing, execuções iterativas são a forma mais rápida de confirmar que a skill está melhorando um setup real em funcionamento, em vez de só gerar um relatório pontual.