Context Budget
Analiza la sobrecarga de tokens en cada componente cargado en una sesión de Claude Code y genera optimizaciones prácticas para recuperar espacio de contexto.
Cuándo Usarlo
- El rendimiento de la sesión se siente lento o la calidad de salida está degradándose
- Has agregado recientemente muchas habilidades, agentes o servidores MCP
- Quieres saber cuánto margen de contexto tienes realmente
- Planeas agregar más componentes y necesitas saber si hay espacio
- Ejecutando el comando
/context-budget(este skill lo respalda)
Cómo Funciona
Fase 1: Inventario
Escanea todos los directorios de componentes y estima el consumo de tokens:
Agentes (agents/*.md)
- Cuenta líneas y tokens por archivo (palabras × 1.3)
- Extrae la longitud del frontmatter
description - Marca: archivos >200 líneas (pesados), descripción >30 palabras (frontmatter hinchado)
Habilidades (skills/*/SKILL.md)
- Cuenta tokens por SKILL.md
- Marca: archivos >400 líneas
- Busca copias duplicadas en
.agents/skills/— omite copias idénticas para evitar doble conteo
Reglas (rules/**/*.md)
- Cuenta tokens por archivo
- Marca: archivos >100 líneas
- Detecta superposición de contenido entre archivos de reglas en el mismo módulo de idioma
Servidores MCP (.mcp.json o configuración MCP activa)
- Cuenta servidores configurados y total de herramientas
- Estima sobrecarga de esquema en ~500 tokens por herramienta
- Marca: servidores con >20 herramientas, servidores que envuelven comandos CLI simples (
gh,git,npm,supabase,vercel)
CLAUDE.md (nivel de proyecto + nivel de usuario)
- Cuenta tokens por archivo en la cadena CLAUDE.md
- Marca: total combinado >300 líneas
Fase 2: Clasificar
Ordena cada componente en un cubo:
| Cubo | Criterio | Acción |
|---|---|---|
| Siempre necesario | Referenciado en CLAUDE.md, respalda un comando activo, o coincide con el tipo de proyecto actual | Mantener |
| A veces necesario | Específico de dominio (ej. patrones de idioma), no referenciado en CLAUDE.md | Considerar activación bajo demanda |
| Raramente necesario | Sin referencia de comando, contenido superpuesto, o sin coincidencia obvia con el proyecto | Eliminar o carga diferida |
Fase 3: Detectar Problemas
Identifica los siguientes patrones problemáticos:
- Descripciones de agentes hinchadas — descripción >30 palabras en frontmatter que se carga en cada invocación de la herramienta Task
- Agentes pesados — archivos >200 líneas inflan el contexto de la herramienta Task en cada generación
- Componentes redundantes — habilidades que duplican lógica de agentes, reglas que duplican CLAUDE.md
- Suscripción excesiva a MCP — >10 servidores, o servidores que envuelven herramientas CLI disponibles gratuitamente
- Hinchazón de CLAUDE.md — explicaciones verbosas, secciones desactualizadas, instrucciones que deberían ser reglas
Fase 4: Informe
Genera el informe de presupuesto de contexto:
Informe de Presupuesto de Contexto
═══════════════════════════════════════
Sobrecarga total estimada: ~XX,XXX tokens
Modelo de contexto: Claude Sonnet (ventana de 200K)
Contexto efectivo disponible: ~XXX,XXX tokens (XX%)
Desglose de Componentes:
┌─────────────────┬────────┬───────────┐
│ Componente │ Conteo │ Tokens │
├─────────────────┼────────┼───────────┤
│ Agentes │ N │ ~X,XXX │
│ Habilidades │ N │ ~X,XXX │
│ Reglas │ N │ ~X,XXX │
│ Herramientas MCP│ N │ ~XX,XXX │
│ CLAUDE.md │ N │ ~X,XXX │
└─────────────────┴────────┴───────────┘
ADVERTENCIA: Problemas Encontrados (N):
[ordenados por ahorro de tokens]
Top 3 Optimizaciones:
1. [acción] → ahorro ~X,XXX tokens
2. [acción] → ahorro ~X,XXX tokens
3. [acción] → ahorro ~X,XXX tokens
Ahorros potenciales: ~XX,XXX tokens (XX% de la sobrecarga actual)
En modo verbose, además muestra conteos de tokens por archivo, desglose línea por línea de los archivos más pesados, líneas redundantes específicas entre componentes superpuestos, y lista de herramientas MCP con estimaciones de tamaño de esquema por herramienta.
Ejemplos
Auditoría básica
Usuario: /context-budget
Skill: Escanea configuración → 16 agentes (12,400 tokens), 28 habilidades (6,200), 87 herramientas MCP (43,500), 2 CLAUDE.md (1,200)
Marca: 3 agentes pesados, 14 servidores MCP (3 reemplazables por CLI)
Mayor ahorro: eliminar 3 servidores MCP → -27,500 tokens (47% de reducción de sobrecarga)
Modo verbose
Usuario: /context-budget --verbose
Skill: Informe completo + desglose por archivo mostrando planner.md (213 líneas, 1,840 tokens),
lista de herramientas MCP con tamaños por herramienta, líneas de reglas duplicadas lado a lado
Verificación previa a expansión
Usuario: Quiero agregar 5 servidores MCP más, ¿tengo espacio?
Skill: Sobrecarga actual 33% → agregar 5 servidores (~50 herramientas) añadiría ~25,000 tokens → sube al 45% de sobrecarga
Recomendación: eliminar primero 2 servidores reemplazables por CLI para mantenerse por debajo del 40%
Mejores Prácticas
- Estimación de tokens: usa
palabras × 1.3para prosa,caracteres / 4para archivos con mucho código - MCP es la palanca más grande: cada esquema de herramienta cuesta ~500 tokens; un servidor de 30 herramientas cuesta más que todas tus habilidades combinadas
- Las descripciones de agentes se cargan siempre: incluso si el agente nunca se invoca, su campo de descripción está presente en cada contexto de la herramienta Task
- Modo verbose para depuración: úsalo cuando necesites identificar exactamente los archivos que están impulsando la sobrecarga, no para auditorías regulares
- Auditar después de cambios: ejecuta después de agregar cualquier agente, habilidad o servidor MCP para detectar el aumento temprano