La habilidad /teach

Fuente: The /teach Skill — traducción comunitaria no oficial al español.

Qué hace

teach convierte el directorio donde la ejecutas en un espacio de enseñanza permanente y te enseña un tema a lo largo de muchas sesiones, en lecciones HTML breves y autocontenidas.

No enseña a partir de lo que el modelo ya sabe. El conocimiento paramétrico se trata como no confiable: antes de enseñar, va y busca recursos de alta confianza, los registra en RESOURCES.md y los cita dentro de cada lección. El otro hecho estructural es que tiene estado: la misión, los recursos, las lecciones y el registro de lo que has aprendido viven en el directorio como archivos, así que la siguiente sesión retoma desde esos archivos en lugar de desde lo que quede de la última conversación.

Cuándo usarla

La invocas escribiendo /teach; el agente no la usará por su cuenta.

Úsala cuando el aprendizaje sea el proyecto: un lenguaje, un framework, una base de código a la que acabas de llegar, yoga, shaders, una certificación. No es la herramienta para una explicación puntual de pasada.

Lo que quieres	Qué usar
Aprender un tema durante semanas, con sesiones que se acumulan	teach
Una idea explicada dentro de la sesión en la que ya estás	Solo pregunta, en esa sesión
Que se reformule el último mensaje del agente porque no te llegó	wait-what
Afilar el pensamiento que ya tienes, en lugar de adquirir material nuevo	grill-me
Un agente en segundo plano que lea fuentes primarias y te deje un documento citado	research
Aprender algo que surgió en medio de un interrogatorio, sin descarrilar el interrogatorio	handoff a un espacio de enseñanza, y luego teach allí

Requisitos previos

teach construye un directorio en lugar de producir un archivo, y la habilidad asume una misión por espacio de trabajo, así que ejecútala en un lugar que estés dispuesto a dedicar a un solo tema. Mantenla fuera del proyecto en el que trabajas: un repositorio separado es el hogar recomendado, en lugar de una carpeta global ~/.learnings/ o el propio proyecto de trabajo. Un repositorio dedicado también hace que las lecciones se puedan publicar con commits, que es como los equipos las han compartido.

Lo que se acumula en ese directorio:

Ruta	Qué contiene
MISSION.md	Por qué estás aprendiendo esto. Todo lo demás depende de ello; si falta, lo primero que hace teach es entrevistarte hasta que exista
RESOURCES.md	Las fuentes verificadas desde las que enseña, divididas en Conocimiento y Sabiduría (comunidades)
lessons/*.html	Las lecciones numeradas: la unidad principal de enseñanza
reference/*.html	Hojas de referencia comprimidas, algoritmos, glosarios: los documentos a los que realmente vuelves
learning-records/*.md	Notas estilo ADR sobre lo que has aprendido de forma demostrable, usadas para decidir qué enseñar después
assets/*	Componentes reutilizables, empezando por una hoja de estilos compartida, para que las lecciones parezcan un solo curso
NOTES.md	Tus preferencias de enseñanza declaradas

Dos notas honestas sobre esa lista. Un glosario conviene a la mayoría de los temas, pero la habilidad incluye un GLOSSARY-FORMAT.md al que SKILL.md ya no enlaza, así que solo tendrás uno si lo pides (issue #559). Y el espacio de trabajo no siempre se crea donde esperas, así que consulta la primera pregunta más abajo antes de construir un curso largo sobre él.

Fuerza de almacenamiento, no fluidez

La palabra para pensar es fuerza de almacenamiento: retención a largo plazo, frente a fluidez, la recuperación del momento que se siente como dominio mientras lees y desaparece una semana después. teach construye lo primero mediante dificultad deseable: práctica de recuperación, espaciado, intercalado. El conocimiento viene primero, donde la dificultad es el enemigo porque consume la memoria de trabajo que necesitas para entender; luego la habilidad se ejercita con un ciclo de retroalimentación estrecho, donde la dificultad es la herramienta.

Dos cosas dirigen lo que se te enseña. La misión (la razón concreta del mundo real por la que quieres esto) fundamenta cada lección; sin ella las lecciones derivan a lo abstracto y nada decide qué viene después. Desde la misión y los registros de aprendizaje, teach elige la siguiente lección dentro de tu zona de desarrollo próximo: lo bastante desafiante para exigir esfuerzo, no tan adelantada como para dejar de ser aprendible.

También por eso la habilidad te confronta en lugar de complacerte. Una pregunta que necesita sabiduría (juicio del mundo real) recibe un intento de respuesta y luego un puntero a una comunidad donde puedas probarla. Un cuestionario es una puerta, no una formalidad: un usuario contó que dijo “muchas gracias” y le dijeron que el ejercicio seguía activo.

Lecciones, referencias y componentes

Una lección es un archivo HTML autocontenido, lo bastante corto para terminarse de una sentada, ligado a la misión, que te da una victoria tangible. Cita sus fuentes, recomienda una fuente primaria para que vayas y la leas tú mismo, y enlaza a lecciones hermanas y documentos de referencia.

La división que vale la pena conocer: las lecciones rara vez se revisitan, los documentos de referencia sí. Así que la esencia comprimida de una lección (la tabla de sintaxis, el algoritmo, la secuencia de posturas, el glosario) pertenece a reference/, no enterrada en la lección que la introdujo.

Las lecciones se construyen a partir de componentes en assets/: hojas de estilo, widgets de cuestionarios, simuladores, ayudantes de diagramas. La reutilización es lo predeterminado. El agente lee assets/ antes de redactar una lección y construye a partir de lo que hay, y cualquier novedad que una segunda lección pueda usar se escribe como componente en lugar de incluirse en línea. La hoja de estilos compartida es el primer componente que gana cada espacio de trabajo; es lo que evita que el resultado sea un montón de piezas sueltas.

Preguntas comunes

¿Dónde pone los archivos? Los míos terminaron en ~/.claude/skills. Un error real y abierto (#377). SKILL.md usa ./ para dos raíces distintas a la vez: ./MISSION-FORMAT.md y sus hermanos sí están junto a SKILL.md en la habilidad instalada, mientras que ./lessons/, ./reference/, ./learning-records/ y ./assets/ deberían estar en tu directorio. Un agente que resuelve el primer tipo contra el directorio de instalación de la habilidad luego resuelve el segundo tipo allí también, y escribe tu curso dentro de la carpeta de la habilidad. Comprueba dónde cayó la primera lección antes de construir sobre ella, y nombra el directorio explícitamente al empezar en lugar de confiar en que se entienda “el directorio actual”.

¿Me quedo en una sesión, o empiezo una nueva por lección? Los tres enfoques funcionan: quedarte en la misma sesión, volver a invocar /teach en una sesión nueva, o abrir una sesión nueva en la misma carpeta. Cada lección es su propia invocación. La carpeta es la continuidad, no la conversación. La práctica común es abrir una sesión nueva en el espacio de trabajo y decir /teach next lesson for <topic>.

¿Cómo sé que no me está enseñando algo que se inventó? No lo sabes, solo por la palabra de la habilidad. Lee las fuentes primarias. teach no es lo bastante confiable para confiar en ella sin verificar, y ninguna habilidad construida sobre un LLM lo es. La maquinaria de fundamentación (RESOURCES.md, citas en cada lección, una fuente primaria recomendada por lección) existe para abaratar la verificación, no para eliminarla. El fallo no es hipotético: a un usuario que aprendía un cubo de Rubik 2x2 le dieron secuencias de movimientos fabricadas que no lo resuelven. La lista de diagnóstico para un caso así es modelo, harness, esfuerzo y cuál fue la fuente. El riesgo es mayor en dominios procedimentales con notación precisa, y menor donde el resultado es inmediatamente verificable, como código que puedes ejecutar.

La respuesta correcta del cuestionario es siempre la primera opción. Confirmado por varias personas, en Sonnet, en Opus y en GLM, y aún sin corregir. SKILL.md ahora exige que cada respuesta tenga el mismo número de palabras, lo que elimina una pista distinta (la respuesta correcta solía ser la única totalmente razonada), pero no dice nada sobre la posición. Un colaborador probó una corrección a nivel de instrucción para la posición y contó que la respuesta correcta seguía cayendo en la casilla A 33 veces de 33 en nueve lecciones (#335), lo que apunta a un componente de cuestionario con mezcla en assets/ como la corrección real en lugar de una mejor redacción. Hasta que eso llegue, trata la posición de la respuesta como irrelevante. Tu directorio assets/ es tuyo y puedes cambiarlo, así que pedir un componente que mezcle al renderizar es una corrección local legítima.

Asumió que ya sabía cosas, y usó términos que nunca definió. La queja sustantiva más común. No hay paso de evaluación: teach infiere tu nivel desde la misión y los registros de aprendizaje, y en la primera sesión no hay registros de aprendizaje. Un usuario que la ejecutaba dentro de una cadena de wayfinder lo dijo claro: “Nunca hizo interrogatorio para establecer mi punto de partida, así que asumió mucho sobre lo que yo ya sabía”. Otro contó que las lecciones se apoyaban en jerga sin definir, y una lección adaptada a su hardware cubría lo que el hardware podía hacer sin decir nunca lo que no podía. Dos cosas ayudan: declara tu conocimiento previo y tus lagunas en el primer mensaje, y corrige el nivel en voz alta cuando una lección falle, porque la corrección se convierte en un registro de aprendizaje y dirige la siguiente. Un paso explícito de evaluación del conocimiento es una petición de funcionalidad pendiente (#725), no un comportamiento disponible.

¿Hace repetición espaciada, y sabe cuándo dejar de enseñar? No a lo primero, y no de forma confiable a lo segundo. El espaciado y el intercalado son principios contra los que se diseñan las lecciones, pero nada programa un repaso, y no hay integración con Anki ni con calendario; ambas son peticiones recurrentes. La laguna relacionada son los criterios de salida: como dijo un usuario, teach “es buena haciendo la siguiente lección, pero no tan buena sabiendo cuándo parar y pasar a repasar o a practicar de verdad”. Si quieres repaso o ejercitación en lugar de material nuevo, pídelo; la habilidad no propondrá el cambio por su cuenta.

¿Solo sirve para código? No, y el uso no relacionado con código es la parte mayor del registro: coreano, registro formal japonés, piano, guitarra, diseño de juegos de mesa, OpenSCAD, tramas de películas, certificaciones de Azure y CCNA, exámenes universitarios, y niños de ocho y diez años recibiendo libros imprimibles sobre escape rooms y salamandras. Nada en la habilidad es específico de programación: misión, recursos, zona de desarrollo próximo y ejercitación funcionan igual en cualquier dominio. Dentro del código, el uso reportado más fuerte no es aprender un lenguaje desde cero sino orientarse en una base de código desconocida o en la pila de un equipo nuevo.

¿Con qué modelo la ejecuto? No hay respuesta canónica, y las diferencias reportadas son grandes. Se ha contado que un esfuerzo de razonamiento mayor produce lecciones notablemente mejores que el ajuste medio. Un usuario ejecutó la misma habilidad con Copilot CLI con Codex y obtuvo una sola tarjeta HTML de 30 líneas donde Claude Code produjo una lección completa. Funciona sin modificar en Claude Cowork, según si tu organización permite añadir habilidades allí. Si las lecciones salen flojas, cambia de modelo, de harness o de esfuerzo antes de reescribir tu prompt.

Funciona si

• Lo primero que hace en un directorio vacío es entrevistarte sobre por qué quieres esto, en lugar de producir una lección.
• RESOURCES.md se llena antes que las lecciones, y cada lección nombra una fuente primaria que vale la pena leer por tu cuenta.
• Las afirmaciones de una lección llevan enlaces hacia fuera. Una lección sin citas es la habilidad enseñando de memoria.
• Una lección toma una sentada y te deja capaz de hacer una cosa que antes no podías.
• Abrir una sesión nueva en la carpeta y decir “next lesson” continúa el curso en lugar de reiniciarlo.
• learning-records/ crece, y las lecciones dejan de reenseñar lo que ya has demostrado.
• Las lecciones parecen un solo curso: enlazan la hoja de estilos en assets/ en lugar de llevar cada una la suya.
• Una pregunta que necesita juicio te dirige a un foro, subreddit o clase, no solo a una respuesta.

Dónde encaja

teach es una habilidad independiente para usar cuando quieras. No es un paso en una cadena de construcción y no comparte artefactos con el flujo de ingeniería; es dueña de su directorio y vive allí mientras dure el tema.

Su único vecino real es handoff, por la composición que Matt nombró como respuesta a “¿qué hago si me interrogan sobre algo que no entiendo?”: no pares el interrogatorio para aprender: haz /handoff a un espacio de enseñanza, apréndelo allí con /teach, y vuelve a retomar donde lo dejaste. La alternativa cercana es research, para cuando lo que quieres es un documento citado en lugar de lecciones y retención. Cuando no estés seguro de qué habilidad o flujo encaja, ask-matt te dirige por todo el conjunto.