---
name: eli5
description: >-
  Explicaciones claras y fundamentadas a cualquier nivel de profundidad (ELI5, ELI10, ELI15, Experto), 
  con analogías intuitivas, diagramas visuales y fuentes verificables (The Answer Has Receipts). 
  Inspirada en eli5.cc. Úsala cuando el usuario pida "explícame cómo funciona", "hazme un ELI5 de", 
  "explica como si tuviera 5 años", "desglosa este concepto complejo", "enséñame este tema paso a paso", 
  "crea un plan de aprendizaje", o cuando necesite entender una arquitectura, algoritmo, bug, 
  tecnología o concepto con fuentes y modelos mentales claros.
version: 1.0.0
license: CC-BY-4.0
updated: 2026-08-23
---

# ELI5 Explainer & Learning Engine

Skill inspirada en [eli5.cc](https://eli5.cc): transforma conceptos complejos, algoritmos, arquitecturas, bugs o tecnologías en **explicaciones claras, estructuradas y con fuentes verificables**, adaptadas al nivel de profundidad que el usuario necesita.

---

## Principios Fundamentales

1. **Una idea, cuatro profundidades**: Explicar siempre al nivel solicitado, o presentar la progresión completa para fijar el concepto.
2. **El modelo visual primero**: Un diagrama (ASCII, Mermaid o SVG) o una analogía física clara antes de entrar en abstracciones.
3. **«The Answer Has Receipts» (Fuentes y Citas)**: Respaldar cada afirmación técnica con citas directas, enlaces a documentación oficial (RFCs, MDN, Microsoft Learn, repositorios) o rutas exactas del código local (`archivo:L10-L25`).
4. **Sin relleno ni jerga vacía**: Traducir tecnicismos a lenguaje natural antes de formalizarlos.

---

## Los 4 Niveles de Profundidad

| Nivel | Público objetivo | Enfoque | Elemento clave |
|---|---|---|---|
| **1. ELI5 (5 años)** | Principiante total / Intuitivo | Metáfora de la vida real, cero jerga, qué problema resuelve en el mundo tangible. | Analogía visual sencilla |
| **2. ELI10 (10 años / Fundamentos)** | Curioso / Principiante técnico | Mecánica básica, componentes principales y cómo interactúan entre sí. | Diagrama de flujo simplificado |
| **3. ELI15 (15 años / Aplicado)** | Desarrollador / Estudiante | Funcionamiento bajo el capó, contratos de datos, código de ejemplo y compensaciones (*trade-offs*). | Fragmento de código / Flujo técnico |
| **4. Experto (Deep Dive)** | Ingeniero Senior / Especialista | Definición formal, casos extremos, concurrencia, rendimiento, internals y especificaciones. | Especificación / Arquitectura detallada |

---

## Estructura Estándar de una Explicación ELI5

Cada explicación debe estructurarse siguiendo esta plantilla modular:

```markdown
# 💡 [Nombre del Concepto / Tema]

> **Resumen en una frase**: [Qué es y para qué sirve en menos de 20 palabras].

---

## 🧸 1. Nivel ELI5 (La Gran Analogía)
[Metáfora cotidiana: ej. "Imagina que el espacio es una sábana elástica..."]

### 🎨 Modelo Mental / Diagrama
\`\`\`text
[Diagrama ASCII o Mermaid claro y visual]
\`\`\`

---

## ⚙️ 2. Nivel ELI10 (Cómo Funciona en Realidad)
- **El problema original**: ¿Por qué inventamos esto?
- **Las piezas clave**: Los 2-4 componentes esenciales.
- **El flujo paso a paso**: Qué ocurre del inicio al fin.

---

## 💻 3. Nivel ELI15 (En la Práctica y con Código)
- **Implementación real**: Ejemplo mínimo funcional en código.
- **Casos de uso típicos**: Dónde se aplica en proyectos reales.
- **Cosas que pueden salir mal**: Errores comunes y trampas típicas.

---

## 🔬 4. Nivel Experto (Bajo el Capó)
- **Mecanismos internos**: Memoria, rendimiento, concurrencia o protocolo.
- **Decisiones de diseño y compromisos (Trade-offs)**: Ventajas vs desventajas frente a alternativas.

---

## 🧾 Fuentes y Evidencia (Receipts)
- 🔗 **[Documentación Oficial / RFC / Paper]**: [Enlace o referencia exacta].
- 📂 **Código en este proyecto**: \`src/ruta/al/fichero.ts#L10-L40\` (si aplica).
```

---

## Modo «ELI5 Learn» (Ruta de Aprendizaje Progresiva)

Cuando el usuario no solo quiere resolver una duda puntual sino **aprender un tema o módulo completo** (ej: *"Enséñame Docker desde cero"*, *"Quiero entender toda la arquitectura de este repositorio"*):

1. **Diagnóstico y Meta**: Definir qué sabrá hacer el usuario al final.
2. **Mapa de Lecciones (Curriculum)**: Dividir el tema en 4-6 lecciones secuenciales de menor a mayor complejidad.
3. **Lección Interactiva**:
   - Concepto ELI5 + analogía.
   - Demostración práctica / ejercicio ejecutable.
   - Pregunta de autoevaluación o checklist de verificación.
   - Siguiente paso en la ruta.

---

## Flujo de Trabajo del Agente

1. **Analizar la consulta**:
   - Identificar el tema central (concepto, arquitectura de este repo, bug específico, algoritmo).
   - Determinar si el usuario pidió un nivel específico (ej. *"hazme un ELI5"*) o una visión integral (los 4 niveles).
2. **Consultar las fuentes**:
   - Si es sobre el repositorio actual: leer los archivos reales con `view_file` o `grep_search` para referenciar líneas exactas.
   - Si es sobre tecnología externa: contrastar con documentación oficial y estándares.
3. **Diseñar la analogía y el modelo visual**:
   - Elegir una metáfora intuitiva que no distorsione la verdad técnica.
   - Generar un diagrama ASCII o Mermaid limpio.
4. **Redactar con claridad**:
   - Mantener el tono riguroso pero accesible.
   - Incluir la sección de fuentes/referencias (`Receipts`).