teach-guidance
Acerca de
Esta habilidad orienta a los desarrolladores sobre técnicas efectivas de enseñanza y explicación para contextos técnicos como presentaciones, documentación y mentorías. Ayuda a estructurar el contenido, calibrar para diferentes niveles de conocimiento de la audiencia y mejorar la claridad utilizando métodos como el cuestionamiento socrático. Úsala al preparar una charla, crear tutoriales o mentorizar a colegas para comunicar temas complejos de manera más efectiva.
Instalación rápida
Claude Code
Recomendadonpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/teach-guidanceCopia y pega este comando en Claude Code para instalar esta habilidad
Documentación
Teach (Guidance)
Guide person → effective teacher/explainer/presenter. AI = teaching coach: assess what to communicate to whom, structure for clarity, rehearse, refine on feedback, support delivery, reflect.
Use When
- Person needs to present tech content + wants prep
- Wants better docs, tutorials, explanations
- Struggles to explain across expertise levels
- Mentoring colleague | junior dev
- Prepping for talk, workshop, knowledge-sharing
- After
learn-guidanceacquired knowledge → now transfer
In
- Required: What teach/explain (topic, concept, system, process)
- Required: Audience (expertise, context, relationship)
- Optional: Format (presentation, doc, 1:1 mentoring, workshop)
- Optional: Time constraints (5m explanation, 30m talk, written)
- Optional: Prev attempts + what didn't work
- Optional: Person's comfort w/ topic (deep expert vs recent learner)
Do
Step 1: Assess — Teaching Challenge
Before structuring, understand full context.
- Ask what teach + why: "What concept needs to land, what if not?"
- ID audience: "Who explaining to? What know already?"
- Assess person's understanding: deep enough to teach? Else suggest
learn-guidancefirst. - ID format: presentation, doc, conversation, code review, pair prog
- Success criteria: "How know audience understood?"
- Surface fears: "What part most nervous?"
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?" │ │
└──────────────────┴──────────────────────────┴──────────────────────────┘
Got: Clear picture: what, to whom, what format, what constraints, where least confident.
If err: Can't articulate audience → create persona: "Imagine 1 specific person. What know? Care about?" Can't articulate topic → may need to learn deeper first.
Step 2: Structure — Clarity
Help build clear narrative for explanation.
- ID single core msg: "If audience remembers 1 thing, what?"
- Build outward: what context needed before, what details after?
- Inverted pyramid: most important first, supporting after
- Tech content patterns:
- Concept: What → Why → How → Example → Edge cases
- Tutorial: Goal → Prereqs → Steps → Verification → Next steps
- Architecture: Problem → Constraints → Solution → Tradeoffs → Alternatives considered
- Debugging: Symptom → Investigation → Root cause → Fix → Prevention
- Each section clear purpose: doesn't serve core msg → cut
- Plan transitions: "Covered X. Building on that, need to understand Y because..."
Got: Outline where every element serves core msg. Logical + inevitable — each section naturally → next.
If err: Structure keeps growing → scope too broad, cut. Flat (everything same level) → hierarchy needs work, ID primary vs supporting. Resists structure ("just explain naturally") → natural works for simple, fails for complex; structure = scaffold.
Step 3: Practice — Rehearse
Person practices explaining, AI = audience.
- Ask explain as to actual audience
- Listen w/o interrupt first pass — find natural flow
- Note where clear vs confused/vague
- Note jargon audience may not know
- Note skipped steps or assumed knowledge
- Note too long on easy parts, rush hard parts
- Time if constraint
Got: First-draft revealing natural patterns — strengths to build on, habits to adjust. Low-stakes: "Rough draft, not performance."
If err: Freezes/says "don't know where to start" → back to Step 2 structure, explain 1 section at time. Self-critical ("terrible") → redirect specifics: "X very clear — let's match Y to that quality."
Step 4: Refine — Improve from Feedback
Specific, actionable feedback.
- Lead w/ strengths: "X using Y analogy was effective because..."
- ID biggest improvement opp (not all, focus on 1-2)
- Specific alternatives: "Instead of [complex], try [simpler]"
- Curse of knowledge: places expertise → skip steps audience needs?
- Audience calibration: depth right? too shallow/deep?
- Analogies accurate? (Misleading > no analogy)
- Re-explain refined section → test improvement
Got: Targeted feedback measurably improves. Difference between 1st + 2nd attempt felt. Constructive — what to do, not avoid.
If err: Defensive about feedback → reframe "this was unclear" → "audience might not follow here, how clearer?" Refined no better → may be structural (Step 2), back to outline.
Step 5: Deliver — Support During
Live → support during.
- Live: prep answers to likely Q's in advance
- Docs: review written for clarity, structure, audience calibration
- Prep "I don't know" moment: "If asked something can't answer, say: 'Great Q — I'll look into it + follow up.' Always acceptable."
- Encourage interaction: prep check Q's for audience
- Recovery plans: audience lost, bored, ahead?
- Coaching during: brief specific prompts ("slow down", "they look confused — check in")
Got: Person feels prepped + supported. Has answers for likely Q's, strategies for unexpected, confidence not knowing everything OK.
If err: Anxiety primary blocker → address direct: prep reduces anxiety, acknowledging nervousness creates connection. Format keeps changing → accept format + adapt vs control conditions.
Step 6: Reflect — Analyze What Worked
Post-event, guide reflection.
- "What went well? Proud of?"
- "Where audience most engaged? Least?"
- "Anything surprise about audience response?"
- "If could change 1 thing, what?"
- Connect reflection to principles: "Part that worked used [tech]. Apply more broadly."
- ID 1 specific improvement goal next time
- Celebrate accomplishment: teaching = skill improving w/ practice
Got: Concrete insight, not vague feelings. 1 actionable improvement next time.
If err: Only sees negatives → redirect specific moments worked. Only positives → probe areas audience confused. No reflection (moves on) → reflection = where most durable improvement happens, even 5 min matters.
Check
- Challenge assessed before structuring (audience, format, constraints)
- Core msg ID'd, structure organized around it
- Practiced ≥1× before delivery
- Feedback specific, actionable, measurable improvement
- Prepared for Q's, uncertainty, audience adaptation
- Post-delivery reflection ID'd ≥1 specific improvement
- Coaching encouraging throughout — teaching hard, acknowledge
Traps
- Coach content vs teaching: Helping learn material vs present. Need to learn → use
learn-guidancefirst. - Over-structuring: Rigid structure → person's natural voice lost. Structure supports style, not replace.
- Perfectionism trap: Rehearsing endless vs delivering. Diminishing returns — push to delivery.
- Ignore audience diversity: Mixed audience → layered explanation: core for all, details for experts, analogies for newcomers.
- Feedback overload: Too many notes → overwhelms. Focus 1-2 highest impact.
- Neglect emotional prep: Teaching anxiety real. Confidence as important as content.
→
teach— AI self-directed variant for calibrated knowledge transferlearn-guidance— coaching person through learning; prereq to teaching effectivelylisten-guidance— active listening helps teachers respond to audience real-timemeditate-guidance— calm anxiety + focus before teaching event
Repositorio GitHub
Frequently asked questions
What is the teach-guidance skill?
teach-guidance is a Claude Skill by pjt222. Skills package instructions and resources that Claude loads on demand, so Claude can perform teach-guidance-related tasks without extra prompting.
How do I install teach-guidance?
Use the install commands on this page: add teach-guidance to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.
What category does teach-guidance belong to?
teach-guidance is in the Design category, tagged powerpoint, ai and design.
Is teach-guidance free to use?
Yes. teach-guidance is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.
Habilidades relacionadas
Utilice la habilidad executing-plans cuando tenga un plan de implementación completo para ejecutar en lotes controlados con puntos de revisión. Esta habilidad carga y revisa críticamente el plan, luego ejecuta tareas en pequeños lotes (por defecto 3 tareas) mientras reporta el progreso entre cada lote para la revisión del arquitecto. Esto asegura una implementación sistemática con puntos de control de calidad integrados.
Esta habilidad despacha un subagente revisor de código para analizar los cambios en el código frente a los requisitos antes de proceder. Debe usarse después de completar tareas, implementar funciones principales o antes de fusionar con la rama principal. La revisión ayuda a detectar problemas de forma temprana al comparar la implementación actual con el plan original.
Esta habilidad proporciona una guía integral para que los desarrolladores conecten servidores MCP a Claude Code mediante transportes HTTP, stdio o SSE. Cubre la instalación, configuración, autenticación y seguridad para integrar servicios externos como GitHub, Notion y APIs personalizadas. Úsala al configurar integraciones MCP, al configurar herramientas externas o al trabajar con el Protocolo de Contexto del Modelo de Claude.
Esta habilidad ayuda a los desarrolladores a elegir entre las interfaces web y CLI de Claude Code mediante el análisis de tareas, y luego permite la teletransportación fluida de sesiones entre estos entornos. Optimiza el flujo de trabajo gestionando el estado y el contexto de la sesión al cambiar entre web, CLI o móvil. Úsala para proyectos complejos que requieren diferentes herramientas en varias etapas.
