📖 Glosario vivo (lee antes — vuelve siempre que lo necesites)
Este módulo introduce el vocabulario de skills con memoria. Fija estos términos: vuelven durante todo el módulo:
mission.md, el learning record, las lecciones). Es el cuaderno del estudiante.🧠 Stateful × stateless
🧠 Imagínalo así: dos profesores. El primero te da una clase perfecta y, al día siguiente, no tiene idea de quién eres: empieza desde cero cada vez. El segundo tiene un cuaderno sobre ti: sabe lo que ya aprendiste, dónde te trabaste y qué sigue. El segundo profesor es stateful. Es lo que imita la Teach skill.
La mayoría de las skills que viste hasta aquí es stateless — sin memoria. La grill-me, por ejemplo: te entrevista, llega a un entendimiento y listo; la próxima vez empieza desde cero. Eso es excelente para tareas puntuales. Pero enseñar es diferente: nadie aprende desde cero en cada clase. Por eso la Teach skill es stateful — ella guarda estado en un espacio de trabajo (una carpeta de trabajo) para recordar lo que hiciste.
En palabras de Pocock, la skill Teach "se ejecuta en un workspace — allí guarda el estado". Esta es la clave técnica del módulo: el «recordar» no es magia del modelo (el modelo olvida todo al final de cada conversación); es archivo guardado en el disco. La skill escribe lo que aprendió sobre ti y, en la próxima sesión lee estos archivos de vuelta. Error común: creer que el agente "recuerda" por sí solo. No: sin un estado guardado, no hay memoria. Lo especial que hace la skill Teach es convertir la memoria en archivos que sobreviven al reinicio de la conversación.
A la izquierda, sesiones sueltas (sin estado). A la derecha, todas escriben y leen el mismo workspace — por eso la Teach skill lo recuerda.
⚠️ Error común de principiante
Confundir el contexto de la conversación (que el modelo «recuerda» solo mientras la ventana está abierta) con estado guardado. Cuando reinicias la conversación, el contexto desaparece: solo lo que esté en archivo sobrevive. Stateful = archivo en disco, no memoria del modelo.
En 1 frase: stateless olvida en cada sesión; stateful guarda archivos y recuerda, y enseñar exige recordar.
Profundiza (opcional): ¿toda skill debería ser stateful?
No. El estado tiene un costo: la skill necesita una carpeta, reglas sobre dónde guardar las cosas y cuidado para no «recordar» algo equivocado. La mayoría de las skills son stateless a propósito: más simples y previsibles. El estado solo vale la pena cuando la tarea continúa en el tiempo: enseñar, acompañar un proyecto largo, llevar un diario de decisiones. Pocock contrasta la Teach (stateful) precisamente con skills como grill-me (stateless), que no necesitan estado local.
🎯 El mission.md
🧠 Imagínalo así: un buen entrenador personal no pregunta "¿qué ejercicio quieres hacer?". Pregunta "¿a dónde quieres llegar?". Si dices "quiero correr un maratón", arma todo a partir de eso. El mission.md es esta conversación, escrita en un archivo.
Antes de enseñar cualquier cosa, la Teach skill hace algo contraintuitivo: no pregunta sobre el tema. Te pregunta por tu misión. Pocock describe la demo: un vibe coder quiere "llenar los vacíos". Su prompt es simple, en inglés claro, y habla de la misión (lo que quieres lograr), no del tema. En sus palabras: "talking to a teacher; the agent is my teacher." La skill entonces se alinea con lo que quieres y crea el mission.md.
O mission.md tiene cuatro preguntas clave: quién eres tú, lo que quieres construir, por qué importa e cómo es el éxito. Pocock cita ejemplos de las preguntas que hace la skill: «¿qué estás construyendo?», «¿qué ship better software significa para ti?", "¿cuál es el proyecto concreto?". Detrás de esto hay una definición sólida de enseñanza: "teaching = not getting info into your head but orienting you in the world" — enseñar no es volcar información en tu cabeza, es orientarse en el mundo. Por eso la misión va antes que el contenido: sin saber adónde vas, cualquier clase es genérica.
Abajo está un mission.md de ejemplo, en el formato que la skill Teach produciría para ese mismo vibe coder. Fíjate en que es breve y concreto: es el «norte» que guiará todas las lecciones. Copia y adapta el tuyo:
# Mission ## Quem sou Monto apps com IA ha 6 meses (vibe coder). Sei pedir features, mas nao domino os fundamentos por baixo. ## O que quero construir Um SaaS de agendamento pra barbearias. Ja tenho o front no ar, mas quebro o backend toda vez que mexo nele. ## Por que importa Quero parar de depender 100% da IA e conseguir consertar meu proprio codigo quando ele quebra. "Ship better software" = entregar sem medo de quebrar o que ja funciona. ## Como e o sucesso - Entendo git o bastante pra desfazer um erro com confianca - Sei ler uma mensagem de erro e achar a causa sozinho - Escrevo 1 teste que pega uma regressao antes do deploy ## Ponto de partida (a skill preenche) - Maquina: macOS, git instalado, Node 20 - Conhecido: HTML/CSS basico, prompts; Lacunas: git, debugging, testes
Recuperación rápida: ¿por qué la Teach skill pregunta sobre la misión ¿antes del tema?
En 1 frase: el mission.md captura adónde quieres llegar, porque enseñar es orientar, no volcar información.
📒 El registro de aprendizaje
🧠 Imagínalo así: la cartilla de salud de un niño. Ningún médico memoriza a cada paciente — abre la cartilla y ve el historial: qué vacunas recibió, cuáles faltan, qué alergias tiene. La registro de aprendizaje es el cuaderno de tu aprendizaje.
Si el mission.md é o destino, o registro de aprendizaje é o diario del viaje. Pocock enumera lo que guarda: la misión, o punto de partida, las decisiones tomadas y las estimaciones (cuánto falta, qué viene después). La skill lee este archivo al inicio de cada sesión para responder a la pregunta «¿dónde nos quedamos?». Sin él, la skill sería una stateless más — daría la misma clase introductoria para siempre.
¿Dónde empieza Teach skill, según la demo? Es personalizada: ya revisó la configuración de tu máquina (por ejemplo, si git está instalado) y usa esa información para decidir por dónde empezar. Para quien programa con vibe coding, empieza por git (el «botón de deshacer»), después leer errores, debugging, cómo se entrega el software e pruebas. Cada uno de esos pasos se convierte en una decisión registrada en el learning record. Por qué esto importa: el registro transforma a un profesor genérico en un profesor tu — que sabe que ya aprendiste git y que la próxima lección es debugging.
🔬 Ejemplo resuelto: la 2.ª sesión del vibe coder
Observa cómo el estado guardado lo cambia todo entre la sesión de ayer y la de hoy:
Sin learning record (stateless)
Hoy: "¡Hola! ¿Vamos a aprender programación? ¿Ya usas git?" → repite la introducción de ayer. Vuelves a ver la misma clase y pierdes tiempo.
Con learning record (stateful)
Hoy: la skill lee el registro → "Ayer terminaste git e leer errores. Hoy abordamos debugging en tu SaaS de barbería." → continúa desde donde lo dejaste.
En 1 frase: el learning record es la libreta que responde «¿dónde nos quedamos?»: es lo que hace que la skill sea tu.
🖥️ Lecciones en HTML
🧠 Imagínalo así: la diferencia entre recibir una receta garabateada en un papel y abrir un libro de cocina ilustrado, con fotos y pasos numerados. El contenido puede ser el mismo — pero el segundo te enseña mucho mejor. La Teach skill elige el «libro ilustrado».
La Teach skill no vuelca la clase en el terminal. Crea un guía de referencia rápida (una "guía de referencia") y la primera lección en HTML, que abre en el navegador. ¿Por qué? Porque, en palabras de Pocock, el HTML es "más completo que la terminal" — admite títulos, imágenes, colores y bloques de código resaltados. Es la misma lógica que hace que este el curso usa HTML en vez de un archivo de texto: lees mejor, recuerdas mejor.
Y hay un segundo ingrediente: la lección es personalizada. La skill ya revisó la configuración de tu máquina; por eso no te dice "instala git" si git ya está instalado. Dentro de las lecciones hay quizzes e ejercicios reales en la terminal. Sobre los cuestionarios, Pocock es enfático: "quizzes are unreasonably effective" — ellos aumentan la storage strength (fuerza de almacenamiento). En vez de solo leer, te ves obligado a recuperar lo que aprendiste — y recuperar es lo que fija el aprendizaje. Error común: creer que basta con "volver a leer"; la retención real viene de que te pongan a prueba. Verás la teoría detrás de esto en el módulo 3.4.
Profundiza (opcional): ¿por qué los quizzes funcionan tan bien?
Es el llamado testing effect (efecto de la prueba): el acto de recuperar una información de la memoria la fortalece mucho más que simplemente repasarla. Releer da la ilusión de que sabes; ponerte a prueba revela lagunas y, al mismo tiempo, graba la respuesta con más fuerza. Por eso la skill Teach intercala un quiz en cada lección, y por eso este curso tiene los botones de «recuperación rápida» al final de los temas. Más sobre la teoría (ZDP, recall, spaced repetition) en el módulo 3.4.
En 1 frase: lecciones en HTML (más completas que la terminal) + cuestionarios que fuerzan la recuperación = clases que realmente se te quedan.
💾 Estado local que recuerda
🧠 Imagínalo así: un juego que guarda tu progreso en un «save file». Cierras el juego, vuelves semanas después, cargas la partida y estás exactamente donde te quedaste. El workspace de Teach skill es ese save file.
Al juntar todo: el estado local de la Teach skill vive en un workspace y se compone de tres piezas que ya conoces: el mission.md (el destino), el registro de aprendizaje (el diario) y los lecciones en HTML ya generadas. Pocock resume el ciclo: la skill te indica que leer la fuente primaria (en el caso de git, el Libro de Pro Git), te invita a hacer preguntas e a crear la próxima lección. Cada una de estas acciones actualiza el estado: el save file crece en cada sesión.
Aquí está la definición que cierra el módulo, directamente de Pocock: "skill con estado (recuerda lo que hiciste) × sin estado (no necesita estado local)." La Teach skill es el caso poco común en el que vale la pena cargar estado, porque el el aprendizaje es continuo — no cabe en una sesión. Un detalle de implementación importante: cómo la skill es agnóstica del agente, este estado en archivos hace que funcione en Claude Code, Codex y similares (lo instalas con npx skills latest add y elige la teach skill — lo veremos en el módulo 3.6). El estado vive en tu disco, no atado a una herramienta.
En 1 frase: mission + record + lecciones forman un archivo de guardado en tu disco — eso es lo que hace que la skill Teach tenga estado y sea portátil.
🛠️ Recrear el concepto
🧠 Imagínalo así: no necesitas comprar la fábrica de bicicletas para tener una bicicleta: aprendes cómo se arma y montas la tuya. El concepto de Teach skill es lo bastante simple para que tú recrear una versión de ti.
Para cerrar: Teach skill no es magia, sino un patrón. Pocock cuenta que aprendió a resolver el cubo mágico con ella y lo resuelve de memoria; lo llama "extremely effective". Pero lo que la hace buena no es el modelo: es el patrón de skill stateful. Y puedes reutilizar este patrón para cualquier aprendizaje continuo: un espacio de trabajo + mission.md (destino) + learning record (diario) + lecciones detalladas con quiz. Por cierto, Pocock da un consejo directo en esa línea: al corregir errores repetidos, pídele al agente que genere un HTML «tipo teach skill» con los patrones de tus errores. El concepto se puede trasladar. Usa el esqueleto de abajo para armar tu versión:
Voce e meu professor. Trabalhe num workspace e SALVE estado lah. 1) ALINHE A MISSAO (nao o assunto). Pergunte uma de cada vez: - quem sou eu? o que quero construir? por que importa? - como e o sucesso? -> escreva ./workspace/mission.md 2) CHEQUE MEU SETUP (git instalado? linguagem? SO) e registre. 3) MANTENHA UM LEARNING RECORD em ./workspace/record.md: missao, ponto de partida, decisoes, o que vem depois. 4) ENSINE EM LICOES HTML (abrem no navegador, mais ricas que terminal): - personalizadas pro meu setup - com exercicios reais no terminal - 1 quiz por licao (recall > releitura) - aponte a FONTE PRIMARIA pra eu ler 5) AO FIM: convide perguntas + crie a proxima licao + atualize o record. Regra: voce ESQUECE entre sessoes; so o que estiver em arquivo sobrevive.
Recuperación rápida: qué hace que la Teach skill stateful, en la práctica?
En 1 frase: la Teach skill es un patrón (workspace + misión + record + lecciones) que puedes recrear para cualquier aprendizaje continuo.
🧾 Resumen del módulo
Próximo módulo:
3.4 — Enseñanza que se retiene: la teoría detrás de la Teach skill (zona de desarrollo próximo, conocimiento como grafo, recall y spaced repetition).