Agent-almanac learn-guidance
git clone https://github.com/pjt222/agent-almanac
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/es/skills/learn-guidance" ~/.claude/skills/pjt222-agent-almanac-learn-guidance-6910c8 && rm -rf "$T"
i18n/es/skills/learn-guidance/SKILL.mdLearn (Guidance)
Guiar a una persona a través de un proceso de aprendizaje estructurado para un nuevo tema, tecnología o habilidad. La IA actúa como coach de aprendizaje — ayudando a evaluar el conocimiento inicial, planificar una ruta de estudio, recorrer el material al ritmo adecuado, probar la comprensión con preguntas, adaptar el enfoque basándose en la retroalimentación y consolidar para la retención.
Cuándo Usar
- Una persona quiere aprender una nueva tecnología, framework, lenguaje o concepto y no sabe por dónde empezar
- Alguien se siente abrumado por la documentación o los recursos de aprendizaje y necesita una ruta estructurada
- Una persona sigue olvidando el material y necesita orientación sobre repetición espaciada
- Alguien está haciendo la transición entre dominios (ej., backend a frontend) y necesita un análisis de brechas
- Una persona quiere responsabilidad y estructura para el aprendizaje autodirigido
- Después de que
ha limpiado el ruido mental, creando espacio para el aprendizaje enfocadomeditate-guidance
Entradas
- Requerido: Lo que la persona quiere aprender (tema, tecnología, habilidad o concepto)
- Requerido: Su propósito para aprender (requisito laboral, interés personal, necesidad de proyecto, cambio de carrera)
- Opcional: Nivel de conocimiento actual en esta área (autoevaluado o demostrado)
- Opcional: Tiempo disponible para aprender (horas por día/semana, fecha límite si existe)
- Opcional: Estilo de aprendizaje preferido (lectura, práctico, video, discusión)
- Opcional: Intentos previos fallidos de aprender este tema (qué no funcionó antes)
Procedimiento
Paso 1: Evaluar — Determinar la posición inicial
Antes de diseñar una ruta de aprendizaje, comprender dónde se encuentra actualmente la persona.
- Preguntar sobre su experiencia con el tema: "¿Qué sabes ya sobre X?"
- Preguntar sobre conocimiento adyacente: "¿Qué temas relacionados conoces?" (estos se convierten en puentes)
- Si afirman tener algún conocimiento, hacer una pregunta de calibración que revele profundidad vs. familiaridad superficial
- Notar su vocabulario: ¿usan los términos del dominio correctamente, aproximadamente o no los usan en absoluto?
- Identificar su objetivo de aprendizaje específicamente: "Después de aprender esto, ¿qué quieres ser capaz de hacer?"
- Identificar su motivación principal: curiosidad, necesidad práctica, avance profesional o proyecto creativo
Starting Position Assessment: ┌───────────────┬────────────────────────────┬──────────────────────────┐ │ Level Found │ Indicators │ Path Approach │ ├───────────────┼────────────────────────────┼──────────────────────────┤ │ No exposure │ No vocabulary, no mental │ Start with "what" and │ │ │ model, everything is new │ "why" before "how" │ ├───────────────┼────────────────────────────┼──────────────────────────┤ │ Surface │ Has heard terms, no hands- │ Fill vocabulary gaps, │ │ awareness │ on experience, vague model │ then move to hands-on │ ├───────────────┼────────────────────────────┼──────────────────────────┤ │ Partial │ Some experience, gaps in │ Identify specific gaps │ │ knowledge │ understanding, can do some │ and target them directly │ │ │ things but not others │ │ ├───────────────┼────────────────────────────┼──────────────────────────┤ │ Refresher │ Knew it before, now rusty │ Quick review + practice │ │ needed │ │ to reactivate knowledge │ └───────────────┴────────────────────────────┴──────────────────────────┘
Esperado: Una imagen clara de la posición inicial, objetivo y restricciones de la persona. La evaluación debe ser cálida y alentadora, no como un examen — enmarcar las preguntas como curiosidad sobre su experiencia.
En caso de fallo: Si la persona no puede articular su nivel actual, pedirle que describa un intento reciente de usar o comprender el tema. Las historias concretas revelan el nivel con más precisión que la autoevaluación. Si están avergonzados por su nivel, normalizar: "Todos empiezan en algún punto — saber dónde estás me ayuda a diseñar la mejor ruta para ti."
Paso 2: Planificar — Diseñar la ruta de aprendizaje
Crear una ruta estructurada desde su posición actual hasta su objetivo.
- Dividir el tema en 4-7 hitos de aprendizaje (ni demasiado granulares, ni demasiado vagos)
- Ordenar los hitos por dependencia: ¿qué debe entenderse antes de qué?
- Para cada hito, identificar el concepto central (lo que necesitan entender) y la habilidad central (lo que necesitan poder hacer)
- Estimar el tiempo por hito basándose en sus horas disponibles
- Identificar el primer hito — aquí es donde comienza el aprendizaje
- Incorporar victorias tempranas: el primer hito debe ser alcanzable rápidamente para generar impulso
- Presentar la ruta visualmente: una lista numerada con descripciones breves
Esperado: Una ruta de aprendizaje que la persona pueda ver y entender. Debe sentirse manejable — no abrumadora. La persona debe poder señalar cualquier hito y entender por qué está ahí.
En caso de fallo: Si la ruta se siente demasiado larga, el objetivo puede ser demasiado ambicioso para el tiempo disponible — discutir la reducción de alcance. Si la ruta se siente demasiado corta, el tema puede ser más simple de lo esperado — o los hitos son demasiado amplios y necesitan descomposición.
Paso 3: Guiar — Recorrer el material
Para cada hito, guiar a la persona a través del material al ritmo adecuado.
- Introducir el concepto del hito con una breve descripción general: "En esta sección, aprenderemos X, que te permite hacer Y"
- Presentar el material en fragmentos pequeños — un concepto por fragmento
- Usar el estilo de aprendizaje preferido de la persona: lectura → proporcionar texto; práctico → proporcionar ejercicios; discusión → usar preguntas socráticas
- Conectar cada nuevo concepto con algo que ya conocen (de la evaluación)
- Proporcionar ejemplos concretos antes de definiciones abstractas
- Si se usa documentación, guiarlos a través de las secciones relevantes en lugar de enviarlos a leer solos
- Pausar después de cada fragmento: "¿Tiene sentido hasta aquí?"
Esperado: La persona progresa a través del material con comprensión, no solo exposición. Deben poder explicar cada concepto con sus propias palabras antes de pasar al siguiente. El ritmo se siente correcto — ni apresurado, ni arrastrado.
En caso de fallo: Si están teniendo dificultades, reducir la velocidad y verificar prerrequisitos faltantes. Si están avanzando rápidamente, acelerar — no desperdiciar su tiempo en lo que ya dominan. Si el material en sí es confuso (mala documentación), proporcionar una explicación más clara y notar la calidad del recurso para referencia futura.
Paso 4: Probar — Verificar la comprensión
Verificar el aprendizaje con preguntas que requieran aplicación, no solo recuerdo.
- Hacer preguntas de predicción: "¿Qué pasaría si cambiaras X?"
- Hacer preguntas de comparación: "¿En qué se diferencia esto de Y, que aprendiste antes?"
- Hacer preguntas de aplicación: "¿Cómo usarías esto para resolver Z?"
- Hacer preguntas de depuración: "Este código tiene un error relacionado con lo que acabamos de aprender — ¿puedes encontrarlo?"
- Celebrar las respuestas correctas específicamente: "Sí — y la razón por la que funciona es..."
- Para respuestas incorrectas, explorar su razonamiento: "Interesante — guíame a través de tu pensamiento"
- Nunca enmarcar las respuestas incorrectas como fracaso — son información diagnóstica
Esperado: Las pruebas revelan si la persona tiene un modelo mental funcional o un recuerdo superficial. Los modelos funcionales pueden manejar variaciones; el recuerdo superficial no puede. Las pruebas deben sentirse como un ejercicio colaborativo, no como un examen.
En caso de fallo: Si la persona no puede responder preguntas de aplicación, el aprendizaje fue demasiado pasivo — necesitan práctica con las manos antes de más material. Si responden preguntas de recuerdo pero no de aplicación, los conceptos fueron entendidos individualmente pero no integrados — enfocarse en las conexiones entre conceptos.
Paso 5: Adaptar — Ajustar la ruta
Basándose en los resultados de las pruebas y la retroalimentación de la persona, ajustar la ruta de aprendizaje.
- Si un hito fue fácil: considerar combinarlo con el siguiente, o profundizar el contenido
- Si un hito fue difícil: dividirlo en pasos más pequeños, o agregar repaso de prerrequisitos
- Si el interés de la persona cambia durante el aprendizaje: ajustar la ruta para seguir su curiosidad donde sea posible — el compromiso impulsa la retención
- Si están fatigados: sugerir un descanso y una sesión de repaso posterior en lugar de insistir
- Si un enfoque particular de enseñanza no está funcionando: probar una modalidad diferente (cambiar de lectura a práctica, o de abstracto a concreto)
- Actualizar la ruta de aprendizaje y comunicar los cambios: "Basándome en cómo fue esto, sugiero que ajustemos..."
Esperado: La ruta de aprendizaje evoluciona basándose en datos reales. Ningún currículo fijo sobrevive al contacto con un aprendiz real — la adaptación es el valor.
En caso de fallo: Si las adaptaciones repetidas siguen dejando a la persona con dificultades, puede haber una brecha fundamental de prerrequisitos que no fue detectada en la evaluación. Regresar al Paso 1 y profundizar más. Si la persona está perdiendo motivación, discutir el objetivo original — a veces ajustar el objetivo es más apropiado que cambiar la ruta.
Paso 6: Repasar — Consolidar y planificar la siguiente sesión
Solidificar lo aprendido y preparar para el aprendizaje continuo.
- Resumir lo cubierto: "Hoy aprendimos X, Y y Z"
- Pedirles que expresen la conclusión clave con sus propias palabras
- Proporcionar un breve ejercicio de práctica para trabajo independiente (no tarea — refuerzo opcional)
- Recomendar 2-3 recursos para exploración adicional (documentación, tutoriales, ejemplos)
- Si se usa repetición espaciada: programar puntos de repaso — "Repasa estos conceptos de nuevo en 2 días, luego en una semana"
- Preparar el siguiente hito: "La próxima vez, abordaremos..."
- Pedir retroalimentación: "¿Qué funcionó bien? ¿Qué podría hacer diferente?"
Esperado: La persona se va con una comprensión clara de lo que aprendió, lo que puede practicar y lo que viene después. La sesión tiene un cierre limpio, no una parada abrupta.
En caso de fallo: Si la persona no puede expresar una conclusión clave, la sesión cubrió demasiado o muy poco quedó grabado. Identificar el concepto que más necesita refuerzo y enfocar el repaso en eso. Si no tienen motivación para la práctica independiente, la ruta de aprendizaje puede necesitar ser más autónoma (todo el aprendizaje dentro de las sesiones).
Validación
- La posición inicial fue evaluada antes de diseñar la ruta de aprendizaje
- La ruta de aprendizaje tiene hitos claros ordenados por dependencia
- El material fue presentado en fragmentos pequeños con verificaciones de comprensión entre ellos
- Las pruebas usaron preguntas de aplicación, no solo de recuerdo
- La ruta fue adaptada al menos una vez basándose en el progreso real de la persona
- La sesión terminó con un resumen, sugerencia de práctica y próximos pasos
- La persona se sintió alentada durante todo el proceso, no examinada ni juzgada
Errores Comunes
- Sobrecarga de información: Proporcionar todo el material de una vez en lugar de dosificarlo a través de hitos. La sobrecarga mata el aprendizaje
- Omitir la evaluación: Asumir el nivel de la persona en lugar de verificarlo. Un experto en frontend aprendiendo backend puede conocer conceptos adyacentes pero no los que esperas
- Enseñar al promedio: Si la persona es más rápida o más lenta de lo esperado, el ritmo debe cambiar — mantener el plan a pesar de la retroalimentación desperdicia su tiempo o los pierde
- Todo teoría, nada de práctica: La comprensión requiere hacer, no solo escuchar. Cada hito debe incluir un elemento práctico
- Ignorar la motivación: Una persona que no ve por qué un concepto importa no lo retendrá. Conectar cada concepto con su objetivo declarado
- Sobrecargar las sesiones: Intentar cubrir demasiado en una sola sesión. Es mejor cubrir menos con retención que más con olvido
- Coach como conferencista: El coach guía la exploración del aprendiz, no entrega un monólogo. Hacer más preguntas de las que se responden
Habilidades Relacionadas
— la variante autodirigida de la IA para adquisición sistemática de conocimientolearn
— coaching para que una persona enseñe a otros; complementario al coaching de aprendizajeteach-guidance
— limpiar el ruido mental antes de una sesión de aprendizaje mejora el enfoque y la retenciónmeditate-guidance
— comparte el enfoque de observación estructurada que apoya el aprendizaje desde la experienciaremote-viewing-guidance