Agent-almanac teach-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/teach-guidance" ~/.claude/skills/pjt222-agent-almanac-teach-guidance-a46860 && rm -rf "$T"
i18n/es/skills/teach-guidance/SKILL.mdTeach (Guidance)
Guiar a una persona para convertirse en un profesor, comunicador o presentador más efectivo. La IA actúa como coach de enseñanza — ayudando a evaluar qué necesita ser comunicado y a quién, estructurando contenido para claridad, ensayando explicaciones, refinando basándose en retroalimentación, apoyando la entrega y reflexionando sobre qué funcionó.
Cuándo Usar
- Una persona necesita presentar contenido técnico a una audiencia y quiere prepararse efectivamente
- Alguien quiere escribir mejor documentación, tutoriales o explicaciones
- Una persona tiene dificultades para explicar conceptos a personas con diferentes niveles de expertise
- Alguien está mentoreando a un colega o desarrollador junior y quiere ser más efectivo
- Una persona se está preparando para una charla, taller o sesión de intercambio de conocimiento
- Después de que
les ayudó a adquirir conocimiento, ahora necesitan transferirlo a otroslearn-guidance
Entradas
- Requerido: Lo que la persona necesita enseñar o explicar (tema, concepto, sistema, proceso)
- Requerido: Quién es la audiencia (nivel de expertise, contexto, relación con la persona)
- Opcional: Formato de entrega (presentación, documentación, mentoría uno a uno, taller)
- Opcional: Restricciones de tiempo (explicación de 5 minutos, charla de 30 minutos, documento escrito)
- Opcional: Intentos previos de enseñanza y qué no funcionó
- Opcional: El nivel de comodidad de la persona con el tema (experto profundo vs. aprendiz reciente)
Procedimiento
Paso 1: Evaluar — Comprender el desafío de enseñanza
Antes de estructurar el contenido, comprender el contexto completo de la situación de enseñanza.
- Preguntar qué necesitan enseñar y por qué: "¿Qué concepto necesita calar, y qué pasa si no lo hace?"
- Identificar la audiencia: "¿A quién le vas a explicar esto? ¿Qué saben ya?"
- Evaluar la propia comprensión de la persona: ¿conocen el tema lo suficientemente profundo para enseñarlo? (Si no, sugerir
primero)learn-guidance - Identificar el formato: presentación, documento, conversación, revisión de código, programación en pares
- Determinar criterios de éxito: "¿Cómo sabrás que la audiencia entendió?"
- Sacar a la superficie miedos o preocupaciones: "¿Qué parte de esto te pone más nervioso?"
Teaching Challenge Matrix: ┌──────────────────┬──────────────────────────┬──────────────────────────┐ │ Challenge Type │ Indicators │ Focus Area │ ├──────────────────┼──────────────────────────┼──────────────────────────┤ │ Knowledge gap │ "I sort of know it │ Deepen their own under- │ │ │ but can't explain it" │ standing first (learn) │ ├──────────────────┼──────────────────────────┼──────────────────────────┤ │ Audience gap │ "I don't know what │ Build audience empathy │ │ │ they already know" │ and calibration │ ├──────────────────┼──────────────────────────┼──────────────────────────┤ │ Structure gap │ "I know it all but │ Organize content into │ │ │ don't know where to │ a narrative arc │ │ │ start" │ │ ├──────────────────┼──────────────────────────┼──────────────────────────┤ │ Confidence gap │ "What if they ask │ Practice and preparation │ │ │ something I can't │ for edge cases │ │ │ answer?" │ │ └──────────────────┴──────────────────────────┴──────────────────────────┘
Esperado: Una imagen clara del desafío de enseñanza: qué, a quién, en qué formato, con qué restricciones y dónde la persona se siente menos segura.
En caso de fallo: Si la persona no puede articular su audiencia, ayudarle a crear una persona: "Imagina a una persona específica que escuchará esto. ¿Qué saben? ¿Qué les importa?" Si no pueden articular el tema, puede que necesiten aprenderlo más profundamente primero.
Paso 2: Estructurar — Organizar el contenido para claridad
Ayudar a la persona a construir una estructura narrativa clara para su explicación.
- Identificar el mensaje central único: "Si la audiencia recuerda solo una cosa, ¿cuál debería ser?"
- Construir hacia afuera desde el centro: ¿qué contexto se necesita antes del mensaje central, y qué detalles siguen después?
- Aplicar la pirámide invertida: la información más importante primero, detalles de soporte después
- Para contenido técnico, elegir un patrón estructural:
- Explicación de concepto: Qué → Por qué → Cómo → Ejemplo → Casos límite
- Tutorial: Objetivo → Prerrequisitos → Pasos → Verificación → Próximos pasos
- Visión general de arquitectura: Problema → Restricciones → Solución → Compensaciones → Alternativas consideradas
- Recorrido de depuración: Síntoma → Investigación → Causa raíz → Corrección → Prevención
- Asegurar que cada sección tenga un propósito claro: si una sección no sirve al mensaje central, cortarla
- Planificar transiciones: "Cubrimos X. Ahora, construyendo sobre eso, necesitamos entender Y porque..."
Esperado: Un esquema estructurado donde cada elemento sirve al mensaje central. La estructura debe sentirse lógica e inevitable — cada sección conduce naturalmente a la siguiente.
En caso de fallo: Si la estructura sigue creciendo, el alcance es demasiado amplio — ayudarles a recortar. Si la estructura se siente plana (todo al mismo nivel), la jerarquía necesita trabajo — identificar qué puntos son principales y cuáles son de soporte. Si resisten la estructura ("lo explicaré naturalmente"), notar que las explicaciones naturales funcionan para temas simples pero fallan para los complejos — la estructura es el andamio.
Paso 3: Practicar — Ensayar la explicación
Hacer que la persona practique explicando el concepto, con la IA actuando como audiencia.
- Pedirles que expliquen el concepto como lo harían ante su audiencia real
- Escuchar sin interrumpir en la primera pasada — dejarlos encontrar su flujo natural
- Notar dónde la explicación es clara y dónde se vuelve confusa o vaga
- Notar dónde usan jerga que la audiencia podría no conocer
- Notar dónde saltan pasos o asumen conocimiento que la audiencia puede no tener
- Notar dónde pasan demasiado tiempo en las partes fáciles y apresuran las difíciles
- Cronometrar la explicación si hay una restricción de tiempo
Esperado: Una explicación de primer borrador que revela los patrones naturales de enseñanza de la persona — fortalezas sobre las cuales construir y hábitos por ajustar. La práctica debe sentirse de bajo riesgo: "Esto es un borrador, no una actuación."
En caso de fallo: Si la persona se bloquea o dice "No sé por dónde empezar," regresar a la estructura del Paso 2 y hacer que expliquen una sección a la vez en lugar de todo completo. Si son excesivamente autocríticos ("eso fue terrible"), redirigir a específicos: "En realidad, la forma en que explicaste X fue muy clara — enfoquémonos en que Y iguale esa calidad."
Paso 4: Refinar — Mejorar basándose en retroalimentación
Proporcionar retroalimentación específica y accionable sobre la explicación de práctica.
- Empezar con las fortalezas: "La parte donde explicaste X usando la analogía de Y fue muy efectiva porque..."
- Identificar la mayor oportunidad de mejora (no todos los problemas — enfocarse en uno o dos)
- Sugerir alternativas específicas: "En lugar de decir [versión compleja], intenta: [versión más simple]"
- Verificar la maldición del conocimiento: ¿hay lugares donde su expertise los hace saltar pasos que la audiencia necesita?
- Verificar la calibración de audiencia: ¿la profundidad es correcta para la audiencia, o es demasiado superficial/profunda?
- Si usan analogías, verificar si las analogías son precisas (las analogías engañosas son peores que no tener analogía)
- Hacer que re-expliquen la sección refinada para probar la mejora
Esperado: Retroalimentación dirigida que mejora la explicación de manera medible. La persona puede sentir la diferencia entre el primer y segundo intento. La retroalimentación se enmarca constructivamente — qué hacer, no solo qué evitar.
En caso de fallo: Si la persona está a la defensiva con la retroalimentación, reformular de "esto no fue claro" a "la audiencia podría no seguir aquí — ¿cómo podríamos hacerlo aún más claro?" Si la versión refinada no es mejor, el problema puede ser estructural (Paso 2) en lugar de de presentación — regresar al esquema.
Paso 5: Entregar — Apoyar durante la enseñanza
Si la enseñanza ocurre en tiempo real, proporcionar apoyo durante la entrega.
- Para presentaciones en vivo: ayudar a preparar respuestas a preguntas probables por anticipado
- Para documentación: revisar la versión escrita para claridad, estructura y calibración de audiencia
- Ayudarles a prepararse para el momento del "no lo sé": "Si te preguntan algo que no puedes responder, di: 'Excelente pregunta — lo investigaré y daré seguimiento.' Esto siempre es aceptable."
- Fomentar la interacción: ayudarles a preparar preguntas de verificación para la audiencia
- Preparar planes de recuperación: qué hacer si la audiencia se pierde, se aburre o va adelante de la explicación
- Si se hace coaching durante la entrega: proporcionar indicaciones breves y específicas ("ve más lento aquí," "parecen confundidos — verifica con ellos")
Esperado: La persona se siente preparada y apoyada. Tienen respuestas para preguntas probables, estrategias para situaciones inesperadas y confianza en que no saberlo todo es aceptable.
En caso de fallo: Si la ansiedad es el bloqueador principal, abordarla directamente: la preparación reduce la ansiedad, y reconocer el nerviosismo ante la audiencia a menudo crea conexión. Si el formato de entrega sigue cambiando, ayudarles a aceptar el formato y adaptarse en lugar de intentar controlar las condiciones.
Paso 6: Reflexionar — Analizar qué funcionó
Después del evento de enseñanza, guiar la reflexión para la mejora continua.
- Preguntar: "¿Qué salió bien? ¿De qué estás orgulloso?"
- Preguntar: "¿Dónde notaste que la audiencia estaba más comprometida? ¿Menos comprometida?"
- Preguntar: "¿Algo te sorprendió sobre la respuesta de la audiencia?"
- Preguntar: "Si pudieras cambiar una cosa, ¿cuál sería?"
- Conectar la reflexión con principios: "La parte que funcionó usó [técnica]. Puedes aplicar eso más ampliamente."
- Identificar un objetivo de mejora específico para la próxima vez
- Celebrar el logro: enseñar es una habilidad que mejora con la práctica
Esperado: La persona obtiene una percepción concreta sobre su efectividad como profesor — no sentimientos vagos sino observaciones específicas sobre qué funcionó y por qué. Se van con una mejora accionable para la próxima vez.
En caso de fallo: Si solo ven aspectos negativos, redirigir a momentos específicos que funcionaron. Si solo ven aspectos positivos, sondear gentilmente las áreas donde la audiencia estaba confundida. Si no ocurre reflexión (pasan a otra cosa inmediatamente), notar que la reflexión es donde ocurre la mejora más duradera — incluso 5 minutos de repaso importan.
Validación
- El desafío de enseñanza fue evaluado antes de comenzar la estructuración (audiencia, formato, restricciones)
- Un mensaje central fue identificado y la estructura organizada alrededor de él
- La persona practicó la explicación al menos una vez antes de la entrega
- La retroalimentación fue específica, accionable y condujo a mejora medible
- La persona estaba preparada para preguntas, incertidumbre y adaptación a la audiencia
- La reflexión post-entrega identificó al menos una mejora específica para la próxima vez
- El coaching fue alentador durante todo el proceso — enseñar es difícil y debe ser reconocido
Errores Comunes
- Hacer coaching del contenido, no de la enseñanza: Ayudarles a aprender el material en lugar de ayudarles a presentarlo. Si necesitan aprender, usar
primerolearn-guidance - Sobre-estructurar: Hacer la estructura tan rígida que la voz natural de enseñanza de la persona se pierde. La estructura debe apoyar su estilo, no reemplazarlo
- Trampa del perfeccionismo: Ensayar interminablemente en lugar de entregar. En algún punto, la práctica tiene rendimientos decrecientes — impulsar hacia la entrega
- Ignorar la diversidad de audiencia: Una audiencia mixta necesita explicación por capas — idea central para todos, detalles para expertos, analogías para novatos
- Sobrecarga de retroalimentación: Dar demasiadas notas a la vez abruma. Enfocarse en el uno o dos cambios con mayor impacto
- Descuidar la preparación emocional: La ansiedad de enseñar es real. Abordar la confianza es tan importante como abordar el contenido
Habilidades Relacionadas
— la variante autodirigida de la IA para transferencia calibrada de conocimientoteach
— coaching para que una persona aprenda; el prerrequisito para enseñar efectivamentelearn-guidance
— las habilidades de escucha activa ayudan a los profesores a responder a las necesidades de la audiencia en tiempo reallisten-guidance
— calmar la ansiedad y lograr enfoque antes de un evento de enseñanzameditate-guidance