Presupuesto de Contexto
Analiza la sobrecarga de tokens en cada componente cargado en una sesión de Claude Code y presenta optimizaciones accionables para recuperar espacio de contexto.
Cuándo Usarlo
- El rendimiento de la sesión parece lento o la calidad de la salida se está degradando
- Has agregado recientemente muchos skills, agentes o servidores MCP
- Quieres saber cuánto margen de contexto tienes realmente
- Planeas agregar más componentes y necesitas saber si hay espacio
- Al ejecutar 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 inflado)
Skills (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 número total de herramientas
- Estima la sobrecarga del esquema en ~500 tokens por herramienta
- Marca: servidores con >20 herramientas, servidores que envuelven comandos CLI simples (
gh,git,npm,supabase,vercel)
CLAUDE.md (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 del dominio (ej. patrones de lenguaje), 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 cargar de forma diferida |
Fase 3: Detectar Problemas
Identifica los siguientes patrones problemáticos:
- Descripciones de agente infladas — descripción >30 palabras en el frontmatter 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 — skills que duplican la lógica del agente, reglas que duplican CLAUDE.md
- Suscripción excesiva a MCP — >10 servidores, o servidores que envuelven herramientas CLI disponibles gratuitamente
- Inflado de CLAUDE.md — explicaciones extensas, secciones obsoletas, instrucciones que deberían ser reglas
Fase 4: Informe
Produce 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 disponible efectivo: ~XXX,XXX tokens (XX%)
Desglose de Componentes:
┌─────────────────┬────────┬───────────┐
│ Componente │ Conteo │ Tokens │
├─────────────────┼────────┼───────────┤
│ Agentes │ N │ ~X,XXX │
│ Skills │ 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
Ahorro potencial: ~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 skills (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 la expansión
Usuario: Quiero agregar 5 servidores MCP más, ¿tengo espacio?
Skill: Sobrecarga actual 33% → agregar 5 servidores (~50 herramientas) agregarí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 todos tus skills combinados
- Las descripciones de agente 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 los archivos exactos que impulsan la sobrecarga, no para auditorías regulares
- Auditar después de cambios: ejecuta después de agregar cualquier agente, skill o servidor MCP para detectar el crecimiento temprano