---
name: control-profundidad
deprecated: true
deprecated-since: "5.8.0"
deprecated-reason: >
  Opus 4.7 no soporta extended thinking con budget fijo — el modelo decide
  dinámicamente cuándo invertir tokens de pensamiento. Los niveles nativos
  de esfuerzo de Claude Code (high | xhigh | max) reemplazan el sistema de
  porcentajes 25/50/75/100% de este skill. Programado para eliminación en
  un release MAJOR futuro. Mantenido ahora por retrocompatibilidad.
deprecated-replacement: >
  Usar niveles de esfuerzo nativos de Claude Code via toggle Shift+Tab o
  configuración de sesión. Para controlar verbosidad del output final,
  usar la regla `brevedad-output.md` (obligatoria y siempre activa).
description: >
  [DEPRECATED — eliminar en próximo MAJOR] Permite al usuario controlar
  la profundidad y extension de las respuestas de Claude. Ofrece 4 niveles
  (25/50/75/100%) con estimacion heuristica de tokens. Cargar cuando el
  usuario pide controlar longitud de respuesta, dice "version corta", "responde
  breve", "dame el detalle completo", "token budget", o variantes similares.
  Para nuevas invocaciones, preferir niveles de esfuerzo nativos de Claude Code.
herramientasPermitidas: [Read, Grep]
exclusiones:
  - "No cargar en proyectos con Opus 4.7 — los niveles nativos `high/xhigh/max` de Claude Code reemplazan este skill; ver tabla de migración en el cuerpo."
  - "No cargar para controlar la longitud del output entre agentes — eso lo hace `reglas/brevedad-output.md` que es obligatoria y siempre activa."
  - "No cargar si el usuario no pidió explícitamente controlar profundidad — no interrumpir el flujo con un menú de niveles no solicitado."
evolvable: true  # default para skill estandar
---
# Control de Profundidad de Respuesta

> **⚠ DEPRECATED**: Opus 4.7 maneja el esfuerzo de razonamiento
> de forma dinámica y no soporta extended thinking con budget fijo. Usar los
> niveles nativos `high | xhigh | max` de Claude Code en lugar del sistema de
> porcentajes. Para verbosidad del output final, aplica la regla
> `brevedad-output.md` que ya es obligatoria. Este skill se mantiene por
> retrocompatibilidad y se eliminará en un release MAJOR futuro.

## Migración recomendada

| Usuario pide | Antes (este skill) | Ahora (nativo) |
|--------------|-------------------|----------------|
| "breve", "tldr", "corto" | Nivel 25% | `brevedad-output.md` (siempre activa) |
| "normal", "balanceado" | Nivel 50% | Default del modelo |
| "detallado", "completo" | Nivel 75% | Effort `xhigh` (default en Claude Code) |
| "exhaustivo", "a fondo" | Nivel 100% | Effort `max` (solo para análisis difíciles) |

Los niveles de esfuerzo se controlan con Shift+Tab en Claude Code o via
configuración por agente (`model: claude-opus-4-7` + el harness decide el
esfuerzo según el contexto).

## Cuándo NO cargar

- El proyecto usa Opus 4.7 como modelo — los niveles nativos de esfuerzo (`high/xhigh/max` via `Shift+Tab`) son el mecanismo correcto; este skill está deprecated.
- Se quiere controlar brevedad del output entre agentes; `brevedad-output.md` ya aplica globalmente, sin necesidad de este skill.
- El usuario no pidió control de profundidad explícitamente — presentar el menú de niveles cuando no fue solicitado es ruido de UX.

## Cuando activar

- El usuario menciona "version corta", "breve", "resumido", "tldr"
- El usuario pide "respuesta detallada", "completa", "exhaustiva"
- El usuario dice "token budget", "cuantos tokens", "controlar longitud"
- El usuario dice "al 25%", "al 50%", "dame la version corta"
- NO activar si el usuario ya eligio un nivel en esta sesion (mantenerlo)
- NO activar si la respuesta es trivial (1 linea)

## Niveles de profundidad

| Nivel | % | Que incluir | Que omitir |
|-------|---|-------------|-----------|
| Esencial | 25% | Respuesta directa, 2-4 oraciones max | Contexto, ejemplos, alternativas |
| Moderado | 50% | Respuesta + contexto necesario + 1 ejemplo | Analisis profundo, edge cases |
| Detallado | 75% | Respuesta estructurada, multiples ejemplos, pros/contras | Edge cases extremos |
| Exhaustivo | 100% | Todo — analisis completo, todas las perspectivas | Nada |

## Atajos — el usuario ya señala el nivel

| Que dice el usuario | Nivel |
|--------------------|-------|
| "breve", "corto", "tldr", "version corta", "1" | 25% |
| "normal", "moderado", "balanceado", "2" | 50% |
| "detallado", "completo", "a fondo", "3" | 75% |
| "exhaustivo", "todo", "sin limites", "4" | 100% |

Si el usuario ya señala el nivel, responder directamente a ese nivel sin preguntar.

## Estimacion heuristica de tokens

Para estimar cuantos tokens usara cada nivel:

- Prosa en español: `palabras x 1.5`
- Codigo: `caracteres / 3.5`
- Mixto: usar el tipo dominante

| Complejidad | Multiplicador (sobre input) |
|-------------|---------------------------|
| Simple (que es X?) | 3x - 8x |
| Media (como funciona X?) | 8x - 20x |
| Alta (diseña/compara/analiza) | 15x - 40x |

## Como presentar opciones

Solo presentar cuando el usuario pide explicitamente controlar profundidad
y NO ha indicado ya un nivel:

```
Profundidad de respuesta:

[1] Esencial  (25%) — respuesta directa, sin contexto
[2] Moderado  (50%) — respuesta + contexto + 1 ejemplo
[3] Detallado (75%) — respuesta completa con alternativas
[4] Exhaustivo(100%) — todo, sin limites

Cual nivel? (1-4)
```

## Gotchas / Errores comunes no obvios

- **Nivel aplicado a output entre agentes**: el agente aplica el nivel 25% al output de un checkpoint o reporte técnico entre agentes, perdiendo información necesaria para el siguiente agente. Causa: el skill dice "solo aplica a respuestas al usuario" pero no se verificó el destino del output. Solución: verificar siempre si el destinatario es el usuario (nivel aplica) o un agente (brevedad-output.md aplica en cambio).
- **Nivel 100% en preguntas simples de diagnóstico**: el usuario pregunta "¿qué versión de Python usan?" con un nivel 100% activo de una sesión anterior y recibe 3 páginas de análisis del ecosistema. Causa: el nivel se mantuvo de la sesión anterior sin verificar si sigue siendo apropiado. Solución: al iniciar una nueva sesión o nueva tarea, verificar si el nivel persistido aplica al contexto actual — si la pregunta es trivial, responder a nivel Esencial independientemente del nivel activo.
- **Estimación heurística de tokens usada como presupuesto real**: el agente estima "este response costará 1500 tokens" con la heurística `palabras × 1.5` y lo usa para tomar decisiones de API budget. Causa: la heurística es para orientar al usuario, no para cálculos de coste. Solución: para presupuesto real de tokens, usar el tokenizer o el callback de tokens del modelo — la heurística tiene margen de error del ±30%.

## Reglas

- Si el usuario eligio un nivel, mantenerlo para el resto de la sesion
- El nivel aplica solo a respuestas al usuario, NO a output entre agentes
  (ahi aplica `brevedad-output.md` siempre)
- No preguntar en cada mensaje — solo cuando el usuario lo pide
- Complementa, no reemplaza, la regla de brevedad de agentes
