Skip to content
jesusprodriguez.com

eli5

ELI5 Explainer & Learning Engine

Clear explanations across 4 depth levels (ELI5 to Expert): intuitive analogies, visual diagrams, and verified sources.

stack:
Applied AI
version:
v1.0.0
updated:
size:
5.3 KB
read:
3 min
license:
CC-BY-4.0

When it fires

When asking to explain a complex concept, algorithm, architecture, or bug across different depth levels.

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.

  • 4 depth levels
  • Analogies & mental models
  • Visual diagrams
  • Verified sources & citations

How you ask for it

> Explain how OAuth2 and JWT authentication work across 4 depth levels, starting with an ELI5.

Say this to the agent as it is: the skill loads itself from its description, you do not have to name it.

How to install one

/plugin marketplace add https://jesusprodriguez.com/skills/marketplace.json
/plugin install ingenieria@jprodriguez-toolkit

The native route, and the only one that updates itself: add the marketplace once and `/plugin marketplace update` brings in new versions. Skills get their own namespace (`azure-devops:azure-pr-review`).

The whole file

This is exactly what you download: no summaries, nothing trimmed.

Heads-up: the skill file itself is written in Spanish. Agents read it fine and answer in your language, but the prose below is not translated.

ELI5 Explainer & Learning Engine

Skill inspirada en 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

NivelPúblico objetivoEnfoqueElemento clave
1. ELI5 (5 años)Principiante total / IntuitivoMetá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écnicoMecánica básica, componentes principales y cómo interactúan entre sí.Diagrama de flujo simplificado
3. ELI15 (15 años / Aplicado)Desarrollador / EstudianteFuncionamiento 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 / EspecialistaDefinició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:

# 💡 [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).