Zurück zu Fähigkeiten

teach-guidance

pjt222
Aktualisiert 2 days ago
7 Ansichten
17
2
17
Auf GitHub ansehen
Designwordpowerpointaidesign

Über

Die `teach-guidance`-Fähigkeit coacht Entwickler darin, wie man technische Konzepte effektiv erklärt. Sie bietet Anleitung zur Strukturierung von Inhalten, zur Anpassung an unterschiedliche Zielgruppen und zur Verbesserung der Klarheit für Präsentationen, Dokumentationen und Mentoring. Nutzen Sie diese Fähigkeit, wenn Sie einen Vortrag vorbereiten, Tutorials schreiben oder Hilfe beim Erklären komplexer Themen für verschiedene Kenntnisstände benötigen.

Schnellinstallation

Claude Code

Empfohlen
Primär
npx skills add pjt222/agent-almanac -a claude-code
Plugin-BefehlAlternativ
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternativ
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/teach-guidance

Kopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren

Dokumentation

Teach (Guidance)

Guide person in becoming more effective teacher, explainer, or presenter. AI acts as teaching coach — helps assess what needs communicated and to whom, structures content for clarity, rehearses explanations, refines based on feedback, supports delivery, reflects on what worked.

When Use

  • Person needs present technical content to audience, wants prepare effectively
  • Someone wants write better documentation, tutorials, or explanations
  • Person struggles explain concepts to people with different expertise levels
  • Someone mentoring colleague or junior developer, wants be more effective
  • Person preparing for talk, workshop, or knowledge-sharing session
  • After learn-guidance helped them acquire knowledge, they now need transfer to others

Inputs

  • Required: What person needs to teach or explain (topic, concept, system, process)
  • Required: Who audience is (expertise level, context, relationship to person)
  • Optional: Format of delivery (presentation, documentation, one-on-one mentoring, workshop)
  • Optional: Time constraints (5-minute explanation, 30-minute talk, written document)
  • Optional: Previous teaching attempts and what did not work
  • Optional: Person's own comfort level with topic (deep expert vs. recent learner)

Steps

Step 1: Assess — Understand Teaching Challenge

Before structuring content, understand full context of teaching situation.

  1. Ask what they need to teach and why: "What concept needs to land, and what happens if it does not?"
  2. Identify the audience: "Who will you be explaining this to? What do they already know?"
  3. Assess the person's own understanding: do they know the topic deeply enough to teach it? (If not, suggest learn-guidance first)
  4. Identify the format: presentation, document, conversation, code review, pair programming
  5. Determine success criteria: "How will you know the audience understood?"
  6. Surface fears or concerns: "What part of this makes you 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 of teaching challenge: what, to whom, in what format, with what constraints, where person feels least confident.

If fail: Person cannot articulate audience? Help create persona: "Imagine one specific person who will hear this. What do they know? What do they care about?" Cannot articulate topic? May need learn it more deep first.

Step 2: Structure — Organize Content for Clarity

Help person build clear narrative structure for explanation.

  1. Identify the single core message: "If the audience remembers only one thing, what should it be?"
  2. Build outward from the core: what context is needed before the core message, and what details follow after?
  3. Apply the inverted pyramid: most important information first, supporting details after
  4. For technical content, choose a structural pattern:
    • Concept explanation: What → Why → How → Example → Edge cases
    • Tutorial: Goal → Prerequisites → Steps → Verification → Next steps
    • Architecture overview: Problem → Constraints → Solution → Trade-offs → Alternatives considered
    • Debugging walkthrough: Symptom → Investigation → Root cause → Fix → Prevention
  5. Ensure each section has a clear purpose: if a section does not serve the core message, cut it
  6. Plan transitions: "We covered X. Now, building on that, we need to understand Y because..."

Got: Structured outline where every element serves core message. Structure should feel logical and inevitable — each section naturally leads to next.

If fail: Structure keeps growing? Scope too broad — help them cut. Structure feels flat (everything at same level)? Hierarchy needs work — identify which points primary and which supporting. They resist structure ("I'll just explain it naturally")? Note natural explanations work for simple topics but fail for complex ones — structure is scaffold.

Step 3: Practice — Rehearse Explanation

Have person practice explaining concept, with AI acting as audience.

  1. Ask them to explain the concept as they would to their actual audience
  2. Listen without interrupting for the first pass — let them find their natural flow
  3. Note where the explanation is clear and where it becomes confused or vague
  4. Note where they use jargon the audience might not know
  5. Note where they skip steps or assume knowledge the audience may not have
  6. Note where they spend too long on easy parts and rush through hard parts
  7. Time the explanation if there is a time constraint

Got: First-draft explanation reveals person's natural teaching patterns — strengths to build on and habits to adjust. Practice should feel low-stakes: "This is rough draft, not performance."

If fail: Person freezes or says "I don't know where to start"? Return to structure from Step 2, have them explain one section at a time rather than whole thing. Over self-critical ("that was terrible")? Redirect to specifics: "Actually, the way you explained X was very clear — let's focus on making Y match that quality."

Step 4: Refine — Improve Based on Feedback

Provide specific, actionable feedback on practice explanation.

  1. Lead with strengths: "The part where you explained X using the analogy of Y was very effective because..."
  2. Identify the biggest improvement opportunity (not all the issues — focus on one or two)
  3. Suggest specific alternatives: "Instead of saying [complex version], try: [simpler version]"
  4. Check for the curse of knowledge: are there places where their expertise makes them skip steps the audience needs?
  5. Check for audience calibration: is the depth right for the audience, or is it too shallow/deep?
  6. If they use analogies, check if the analogies are accurate (misleading analogies are worse than no analogy)
  7. Have them re-explain the refined section to test the improvement

Got: Targeted feedback improves explanation measurable. Person can feel difference between first and second attempt. Feedback framed constructive — what to do, not just what to avoid.

If fail: Person defensive about feedback? Reframe from "this was unclear" to "audience might not follow here — how could we make it even clearer?" Refined version not better? Issue may be structural (Step 2) rather than presentational — return to outline.

Step 5: Deliver — Support During Teaching

Teaching happens in real time? Provide support during delivery.

  1. For live presentations: help prepare answers to likely questions in advance
  2. For documentation: review the written version for clarity, structure, and audience calibration
  3. Help them prepare for the "I don't know" moment: "If asked something you cannot answer, say: 'Great question — I'll look into that and follow up.' This is always acceptable."
  4. Encourage interaction: help them prepare check questions for the audience
  5. Prepare recovery plans: what to do if the audience is lost, bored, or ahead of the explanation
  6. If coaching during delivery: provide brief, specific prompts ("slow down here," "they look confused — check in")

Got: Person feels prepared and supported. They have answers for likely questions, strategies for unexpected situations, confidence that not knowing everything is acceptable.

If fail: Anxiety primary blocker? Address direct: preparation reduces anxiety, acknowledging nervousness to audience often creates connection. Delivery format keeps changing? Help them accept format and adapt rather than trying to control conditions.

Step 6: Reflect — Analyze What Worked

After teaching event, guide reflection for continuous improvement.

  1. Ask: "What went well? What are you proud of?"
  2. Ask: "Where did you notice the audience was most engaged? Least engaged?"
  3. Ask: "Did anything surprise you about the audience's response?"
  4. Ask: "If you could change one thing, what would it be?"
  5. Connect the reflection to principles: "The part that worked used [technique]. You can apply that more broadly."
  6. Identify one specific improvement goal for next time
  7. Celebrate the accomplishment: teaching is a skill that improves with practice

Got: Person gains concrete insight about teaching effectiveness — not vague feelings but specific observations about what worked and why. They leave with one actionable improvement for next time.

If fail: They only see negatives? Redirect to specific moments that worked. They see only positives? Gentle probe for areas where audience was confused. No reflection happens (they move on immediately)? Note reflection is where most durable improvement happens — even 5 minutes of review matters.

Checks

  • Teaching challenge assessed before structuring began (audience, format, constraints)
  • Core message identified, structure organized around it
  • Person practiced explanation at least once before delivery
  • Feedback specific, actionable, led to measurable improvement
  • Person prepared for questions, uncertainty, audience adaptation
  • Post-delivery reflection identified at least one specific improvement for next time
  • Coaching encouraging throughout — teaching is hard and should be acknowledged

Pitfalls

  • Coach content, not teaching: Help them learn material instead of help them present it. They need learn? Use learn-guidance first
  • Over-structuring: Make structure so rigid person's natural teaching voice lost. Structure should support their style, not replace it
  • Perfectionism trap: Rehearse endless instead of delivering. At some point, practice has diminishing returns — push toward delivery
  • Ignore audience diversity: Mixed audience needs layered explanation — core idea for everyone, details for experts, analogies for newcomers
  • Feedback overload: Giving too many notes at once overwhelms. Focus on one or two changes with highest impact
  • Neglect emotional preparation: Teaching anxiety real. Addressing confidence as important as addressing content

See Also

  • teach — AI self-directed variant for calibrated knowledge transfer
  • learn-guidance — coaching person through learning; prerequisite to teaching effective
  • listen-guidance — active listening skills help teachers respond to audience needs in real time
  • meditate-guidance — calming anxiety and achieving focus before teaching event

GitHub Repository

pjt222/agent-almanac
Pfad: i18n/caveman/skills/teach-guidance
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Verwandte Skills

executing-plans

Design

Verwenden Sie die Fähigkeit "executing-plans", wenn Sie einen vollständigen Implementierungsplan zur Ausführung in kontrollierten Batches mit Überprüfungspunkten vorliegen haben. Sie lädt den Plan und überprüft ihn kritisch, führt dann Aufgaben in kleinen Batches (standardmäßig 3 Aufgaben) aus und meldet den Fortschritt zwischen jedem Batch zur Überprüfung durch den Architekten. Dies gewährleistet eine systematische Implementierung mit integrierten Qualitätskontrollpunkten.

Skill ansehen

requesting-code-review

Design

Diese Fähigkeit sendet einen Unteragenten für Code-Review, um Codeänderungen anhand der Anforderungen zu analysieren, bevor fortgefahren wird. Sie sollte nach dem Abschließen von Aufgaben, der Implementierung größerer Funktionen oder vor dem Zusammenführen in den Hauptzweig verwendet werden. Die Überprüfung hilft dabei, Probleme frühzeitig zu erkennen, indem die aktuelle Implementierung mit dem ursprünglichen Plan verglichen wird.

Skill ansehen

connect-mcp-server

Design

Diese Fähigkeit bietet Entwicklern eine umfassende Anleitung, um MCP-Server über HTTP-, stdio- oder SSE-Transports mit Claude Code zu verbinden. Sie behandelt Installation, Konfiguration, Authentifizierung und Sicherheit für die Integration externer Dienste wie GitHub, Notion und benutzerdefinierter APIs. Nutzen Sie sie beim Einrichten von MCP-Integrationen, bei der Konfiguration externer Tools oder bei der Arbeit mit Claude's Model Context Protocol.

Skill ansehen

web-cli-teleport

Design

Diese Fähigkeit unterstützt Entwickler bei der Wahl zwischen Claude Code Web- und CLI-Schnittstellen basierend auf Aufgabenanalysen und ermöglicht nahtloses Session-Teleporting zwischen diesen Umgebungen. Sie optimiert den Workflow, indem sie den Sitzungsstatus und Kontext beim Wechsel zwischen Web, CLI oder Mobilgeräten verwaltet. Nutzen Sie sie für komplexe Projekte, die in verschiedenen Phasen unterschiedliche Werkzeuge erfordern.

Skill ansehen