📖 Glosario vivo (lee antes — vuelve siempre que lo necesites)
Estos son los términos nuevos de este módulo (la base —modelo, agente, skill, contexto— ya la viste en las rutas 1 y 3). Fija estos antes de seguir:
🎯 Zona de desarrollo próximo
🧠 Imagínalo así: un videojuego bien hecho. Si el nivel es demasiado fácil, bostezas y lo dejas. Si es imposible, rompes el control. El juego te atrapa cuando cada nivel es solo un escalón por encima de lo que ya dominas: desafiante, pero alcanzable con un poco de esfuerzo. Ese escalón es exactamente donde creces.
Lo primero que la Teach skill tiene «codificada» (integrada en las instrucciones) es un concepto clásico de la pedagogía: la zona de desarrollo próximo (ZDP). La idea, propuesta por el psicólogo Vygotsky, divide cualquier tema en tres franjas: lo que tú ya puede hacerlo por sí solo, lo que tú puede con ayuda (la ZDP), y lo que está demasiado lejos por ahora. Enseñar bien significa apuntar al rango intermedio: ni repetir lo obvio ni volcar algo para lo que todavía no tienes bases suficientes.
¿Por qué esto importa para una skill de IA? Porque el error típico de un agente sin esta instrucción es lanzar un volcado de datos: suelta de una vez todo lo que sabe sobre el tema. Lo lees, te parece excelente y lo olvidas en 10 minutos: nada quedó en la ZDP, solo pasó por encima. Pocock resume el objetivo: "teaching is not getting info into your head but orienting you in the world" — enseñar no es meter información en tu cabeza, es orientarte en el mundo. Por eso, la skill primero descubre dónde estás (tu punto de partida) para calibrar el siguiente paso dentro de tu ZDP. Error común: creer que "una buena clase = una clase completa". Una buena clase es una clase en el escalón correcto; la completitud se vuelve ruido cuando supera tu límite.
La ZDP es el anillo que brilla: ni el núcleo (ya lo sé) ni el borde (demasiado lejos).
⚠️ Error común de principiante
Pedir «explícame todo sobre X» y recibir un muro de texto. Sin apuntar a la ZDP, la IA entrega volumen, no aprendizaje. Lo correcto es que la skill pregunte en qué punto estás antes de enseñar.
En 1 frase: se aprende en el siguiente escalón — ni en el que ya conoces ni en el que está demasiado lejos.
Para profundizar (opcional): ¿de dónde viene la «ZDP»?
El término es del psicólogo soviético Lev Vygotsky (años 1930). Observó que los niños resuelven, con ayuda de un adulto, problemas que todavía no pueden resolver solos — y que es precisamente en esa franja «asistida» donde se consolida el aprendizaje. Décadas después, esto se convirtió en la base del concepto de scaffolding (andamiaje): dar el apoyo justo y retirarlo a medida que la persona crece. La skill Teach es, en el fondo, un andamiaje automático.
🌐 Conocimiento como grafo
🧠 Imagínalo así: un bosque visto desde arriba. Los árboles son los conceptos; los senderos que conectan unos con otros son las dependencias («para llegar a este claro, primero pasa por aquel»). No puedes «leer un bosque de izquierda a derecha» como si fuera una lista: tiene ramificaciones, atajos y callejones sin salida.
Pocock describe el conocimiento explícitamente como un grafo — o una bosque. Un grafo es simplemente esto: nodos (cada concepto) conectados por bordes (cada relación "para entender A, necesitas B"). Aprender Git, por ejemplo: "commit" depende de entender "archivo" y "cambio"; "branch" depende de "commit"; "merge" depende de "branch". No es una fila recta: es una red donde todo se apoya en algo anterior.
¿Por qué es poderosa esta visión? Porque explica por qué tantas explicaciones fallan: intentan enseñarte un nodo sin que tengas los nodos padres. Es como leer el capítulo 7 sin haber leído del 1 al 6: las palabras pasan, pero no se pegan, porque no tienen dónde anclarse. El grafo también muestra que hay muchos caminos posibles hacia el mismo destino y que algunos son callejones sin salida para tú (dependen de cosas que todavía no tienes). Error común: tratar un tema como una "lista de temas" y estudiar fuera de orden. Si no respetas las conexiones del grafo, vas saltando entre nodos sueltos y nada se conecta.
En 1 frase: el conocimiento es un bosque de conceptos conectados, no una lista — cada nodo se apoya en los anteriores.
🛤️ Camino lineal en el grafo
🧠 Imagínalo así: un guía de senderismo en un bosque enorme. El bosque tiene mil caminos, pero el guía te lleva por una ruta: claro por claro, en el orden que tiene sentido, sin que te pierdas. No necesitas ver todo el bosque — solo el siguiente paso y la guía que conoce el mapa.
Aquí está el truco de la Teach skill. El conocimiento es un grafo (tema 2), pero tú no puedes aprender un grafo — tu atención es lineal, un concepto a la vez. Entonces la skill hace la traducción: traza un camino lineal por el grafo. En palabras de Pocock: la skill ve el conocimiento como un bosque y «crea un camino lineal por el grafo». Elige qué arista seguir ahora, respetando sus dependencias y tu ZDP, y deja el resto para después.
En la demo del video, ella hace eso para un vibe coder que quiere llenar vacíos: el camino empieza por git (el «botón de deshacer»), después leer mensajes de error, después depurar, después cómo se entrega el software, después pruebas — un orden deliberado, cada paso apoyado en el anterior. La skill también mantiene el registro de aprendizaje para recordar dónde estás en el camino, y te manda leer la fuente primaria (en el caso de git, el libro Pro Git) en vez de confiar solo en su resumen. Error común: querer "ver el mapa completo" antes de empezar. El camino lineal existe precisamente para que no te bloquees ante la inmensidad del grafo: confía en el siguiente paso.
El mismo grafo del tema 2, ahora con la ruta lineal iluminada (el camino del vibe coder en la demo).
🔬 Ejemplo resuelto: la skill Teach diseñando tu camino
Instalas la skill (npx skills latest add → elige «teach») y di misión, no el tema: "quiero entregar mejor software; tengo una app en Next.js que modifico con vibe-coding, pero rompo cosas y no sé cómo deshacerlas." Mira lo que hace la skill, en orden:
- Alinea la misión — pregunta qué estás construyendo, qué significa para ti «mejor software», qué proyecto concreto. Crea el MISSION.md.
- Ubica en el grafo — ves que tu objetivo de nivel superior ("no romper / saber deshacer") depende de git, y que git es tu punto de partida.
- Traza el camino lineal — git → leer errores → debugging → deploy → pruebas. Aplaza todo lo que no esté en tu ZDP ahora.
- Personaliza — revisa tu máquina (¿Git está instalado?), genera una hoja de referencia + la 1.ª lección en HTML (se abre en el navegador, más completo que el terminal), con ejercicios reales en el terminal.
- Señala la fuente primaria — te manda a leer el libro Pro Git y te invita a preguntar y pedir la siguiente lección.
Resultado: no recibes «un curso de git». Recibes el tuyo camino dentro del grafo de git — calibrado según tu misión.
En 1 frase: la skill transforma el bosque (grafo) en un sendero (camino lineal) que realmente puedes recorrer.
🧠 Cuestionarios y recuperación activa
🧠 Imagínalo así: leer un mapa cien veces no te hace recordar el camino. Pero intentar recorrer el camino con los ojos cerrados una vez, y equivocarte y corregir, graba la ruta. Releer es reconocer; intentar recordar es grabar.
Esta es la pieza que más diferencia la Teach skill de un «resumen bonito». Usa quizzes a propósito — y Pocock es categórico: "quizzes are unreasonably effective" (los cuestionarios son absurdamente eficaces). El motivo tiene un nombre en la ciencia del aprendizaje: recall (recuperación activa). Cada vez que tú trae una respuesta de la mente en vez de solo releer: fortaleces la ruta neuronal de ese conocimiento.
El efecto técnico: el quiz aumenta la storage strength (fuerza de almacenamiento), exactamente lo que Pocock dice que busca la skill: «usa quizzes para aumentar la fuerza de almacenamiento». Releer te da una ilusión de dominio (reconoces el texto y crees que sabes), pero reconocer ≠ recordar. Por eso las lecciones de la skill incluyen ejercicios reales en la terminal, no solo preguntas de opción múltiple: el ejercicio es el recall más potente que existe —tú produces la respuesta en el entorno real. Error común: "estudiar" releyendo. Releer es cómodo y casi inútil para retener; la incomodidad de intentar recordar es precisamente la señal de que está funcionando.
Recuperación rápida: ¿por qué la Teach skill prefiere los quizzes a simplemente releer?
En 1 frase: traer la respuesta de la memoria (recall) la graba; volver a leerla solo permite reconocerla; por eso los cuestionarios.
⏳ Repetición espaciada
🧠 Imagínalo así: regar una planta. Un balde de agua de una vez ahoga la raíz y se escurre. Un poco de agua en los intervalos adecuados hace que la planta crezca fuerte. La memoria es igual: las gotas espaciadas superan a repasar todo de una vez.
Los cuestionarios fijan los conocimientos (tema 4), pero la memoria se filtra con el tiempo — es la "curva del olvido". El antídoto es la repetición espaciada (repetición espaciada): revisar el mismo concepto de nuevo justo antes de que lo olvides, en intervalos que van creciendo (1 día, 3 días, 1 semana, 1 mes). Cada revisión exitosa amplía el intervalo siguiente. Es lo opuesto a "pasar la noche estudiando": el cramming te llena la cabeza durante horas y se vacía en días.
¿Dónde entra esto en Teach skill? Aquí es donde el hecho de que sea una skill stateful (vimos en 3.3) marca la diferencia. Como mantiene el registro de aprendizaje, sabe lo que ya viste y cuando — así puede traerte de vuelta conceptos antiguos en el momento adecuado, en lugar de limitarse a impulsarte contenido nuevo. La propia estructura «termina la lección, pide la siguiente, vuelve a la fuente primaria» incorpora la repetición espaciada a la rutina. Error común: aprender una vez y no volver nunca. Sin repetición espaciada, hasta un recuerdo sólido se desvanece — la retención real exige volver a repasar, no solo ver una vez.
En 1 frase: revisar en intervalos crecientes (gotas, no cubos) vence la curva del olvido.
🎚️ Personalización
🧠 Imagínalo así: un tutor particular que ya conoce tu escritorio, tus herramientas y tu objetivo; por eso nunca te enseña lo que ya sabes ni lo que no te sirve. Es lo opuesto a un manual genérico, igual para todo el mundo.
Todo lo que vimos —ZDP, grafo, camino lineal, recall, spaced repetition— solo funciona porque la skill te conoce. Parte de tu misión ("hablando con un profesor; el agente es mi profesor", dice Pocock), revisa la configuración de tu máquina (¿está instalado git? ¿qué proyecto?) y guarda todo en el registro de aprendizaje. Por eso la primera lección ya viene calibrada: la guía rápida es de tu caso, los ejercicios se ejecutan en el tu terminal.
Es esta suma — principios de aprendizaje reales + estado personal — la que hace que Pocock llame a la Teach skill "extremely effective" y contar que aprendió con ella a resolver el cubo de Rubik de memoria. La lección más importante para ti, que construyes skills: la enseñanza que perdura no consiste en "explicar bien"; es orquestar (apuntar a la ZDP, recorrer el grafo en línea, forzar el recall, espaciar la revisión) según quién sea la persona. Error común: pedir «enséñame X» en general. Di la misión y el punto de partida: eso es lo que activa la personalización. Usa el prompt de abajo como punto de partida:
# Acione a teach skill pela MISSÃO, não pelo assunto. # (instalar antes: npx skills latest add → escolher "teach") Use a teach skill comigo. Minha missão: quero entregar software melhor — tenho um app em Next.js que eu mexo no vibe-coding, mas quebro coisas e não sei desfazer com segurança. Antes de ensinar: 1. Descubra meu ponto de partida (o que eu já sei / não sei). 2. Trace um caminho linear pelo grafo, respeitando a ZDP. 3. Cada lição: HTML no browser + exercício real no terminal. 4. Use quizzes pra fixar (recall) e me lembre de revisar o que vimos antes (spaced repetition). 5. Aponte a fonte primária e salve no learning record.
Recuperación rápida: al activar la Teach skill, ¿de qué debes hablar primero?
En 1 frase: la enseñanza que genera retención es orquestación (ZDP + grafo + recall + espaciado) sobre quien tú é.
🧾 Resumen del módulo
Próximo módulo:
3.5 — Grill-me y skills adversariales: la skill que te entrevista y alinea la comprensión antes de programar.