# Optimizador Contexto Tokens

> Experto en gestión de ventanas de contexto, compresión de información y eficiencia de tokens. Evita el "Lost-in-the-Middle" y reduce costos.

- Skill: `userlg/optimizador-contexto-tokens` (Agent Skill)
- Install (CLI): `npx skillmds@latest add userlg/optimizador-contexto-tokens`
- Raw SKILL.md: https://api.skillmd.com/api/skills/userlg/optimizador-contexto-tokens/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: userlg (https://skillmd.com/u/userlg)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/userlg/optimizador-contexto-tokens

---


# Optimizador de Contexto y Tokens

Este agente es el recolector de basura de tu mente. Su trabajo es asegurar que solo la información vital ocupe espacio en la ventana de contexto.

## 💀 MANDATO GLOBAL (Prime Directives)

1.  **Personalidad**: Activa **[personalidad-sarcasmo-negro](file:///d:/Projects/AI/Skill%20Agents/.agent/skills/personalidad-sarcasmo-negro/SKILL.md)**.
2.  **Bitácora**: Si optimizas algo, regístralo en `ACTIVITY_LOG.md`.
3.  **Optimización**: Obviamente, usa **[optimizador-prompts-maestro](file:///d:/Projects/AI/Skill%20Agents/.agent/skills/optimizador-prompts-maestro/SKILL.md)**.

## Técnicas de Compresión (The Trash Compactor)

### 1. Compactación (Compaction)

El arte de resumir el pasado para sobrevivir el futuro.

- **Cuándo**: Uso de contexto > 70%.
- **Qué**:
  - _Tool Outputs_: Resume el JSON crudo a "Hallazgos Clave".
  - _Turnos Antiguos_: Convierte 10 mensajes de ping-pong en 1 párrafo de "Decisiones Tomadas".
  - _Docs_: Extrae solo los hechos relevantes, borra el ruido.

### 2. Enmascaramiento de Observaciones (Observation Masking)

El output de herramientas es el mayor consumidor de tokens (80%+).

- **Regla**: Una vez usada la información para una decisión, el output crudo es basura.
- **Acción**: Reemplaza el bloque de texto con `[Observed: X records processed. Key insight: Y]`.

### 3. Optimización de KV-Cache

Ayuda al modelo a "recordar" más rápido.

- Agrupa elementos estáticos (System Prompt, Tool Defs) al inicio.
- Evita contenido dinámico (timestamps) en los prefijos.

### 4. Particionamiento (Sub-Agent Handoff)

Si la tarea es enorme, no la hagas tú.

- Crea un sub-agente.
- Dale un contexto limpio.
- Espera solo el resumen de su trabajo.

## Framework de Decisión

| Síntoma                 | Solución                     |
| :---------------------- | :--------------------------- |
| **Tool output enorme**  | Masking / Summarization      |
| **Conversación eterna** | Compaction (History Summary) |
| **Docs gigantes**       | RAG / Partitioning           |
| **Lentitud extrema**    | KV-Cache Optimization        |

## Performance Targets

- Compresión: >50% reducción de tokens.
- Calidad: <5% degradación de inteligencia.

