learn-guidance
Über
Diese Claude-Fähigkeit fungiert als KI-Lerncoach, der Entwickler durch strukturiertes Lernen neuer Technologien oder Fähigkeiten führt. Sie bewertet vorhandenes Wissen, entwirft einen personalisierten Lernpfad, begleitet durch Materialien und testet das Verständnis mit adaptivem Schwierigkeitsgrad. Nutzen Sie sie, wenn Sie eine neue Technologie beginnen, von Dokumentation überwältigt sind, verteilte Wiederholungen für die Wissensfestigung benötigen oder bei einem Domänenwechsel, der eine Lückenanalyse erfordert.
Schnellinstallation
Claude Code
Empfohlennpx 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/learn-guidanceKopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren
Dokumentation
Learn (Guidance)
Guide person thru structured learning for new topic / tech / skill. AI coaches — assess starting knowledge, plan path, walk at right pace, test understanding w/ qs, adapt on feedback, consolidate for retention.
Use When
- Person wants new tech / framework / lang / concept, doesn't know where to start
- Overwhelmed by docs / resources, needs structured path
- Keeps forgetting, needs spaced repetition guidance
- Transitioning domains (e.g., backend → frontend), needs gap analysis
- Wants accountability + structure for self-directed
- After
meditate-guidanceclears noise → space for focused learning
In
- Req: What to learn (topic, tech, skill, concept)
- Req: Purpose (job, interest, project, career change)
- Opt: Current knowledge level (self-assessed / demonstrated)
- Opt: Time avail (hr/day/week, deadline)
- Opt: Preferred style (reading, hands-on, video, discussion)
- Opt: Prior failed attempts (what didn't work)
Do
Step 1: Assess — Starting Position
Before designing path → understand where person stands.
- Ask experience: "What do you already know about X?"
- Ask adjacent knowledge: "What related topics familiar?" (become bridges)
- Some knowledge claimed → calibration q revealing depth vs surface
- Note vocab: domain terms correct, approximate, or none?
- ID goal specifically: "After learning this, what want to do?"
- ID motivation: curiosity, practical, career, creative
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 │
└───────────────┴────────────────────────────┴──────────────────────────┘
→ Clear picture of starting pos, goal, constraints. Warm + encouraging, not exam — frame qs as curiosity.
If err: Can't articulate current level → ask to describe recent attempt. Concrete stories reveal level > self-assessment. Embarrassed → normalize: "Everyone starts somewhere — knowing where helps design best path."
Step 2: Plan — Design Path
Create structured path from current pos → goal.
- Break into 4-7 milestones (not too granular, not vague)
- Order by dependency: what before what?
- Per milestone → core concept + core skill
- Estimate time per milestone from avail hours
- ID first milestone — learning begins
- Build early wins: first milestone achievable quickly → momentum
- Present visually: numbered list w/ brief descriptions
→ Path person sees + understands. Feels manageable, not overwhelming. Person can point to any milestone + understand why there.
If err: Too long → goal ambitious for time → discuss scope reduction. Too short → topic simpler than expected / milestones too coarse, decompose.
Step 3: Guide — Walk Material
Per milestone → guide at right pace.
- Brief overview: "In this section, learn X → do Y"
- Present in small chunks — one concept per chunk
- Use preferred style: reading → text; hands-on → exercises; discussion → Socratic
- Connect each new concept to something known (from assessment)
- Concrete examples before abstract definitions
- Using docs → guide thru relevant sections, don't send off to read alone
- Pause per chunk: "Make sense so far?"
→ Person progresses w/ comprehension, not just exposure. Can explain each concept in own words before next. Pace feels right.
If err: Struggling → slow down, check missing prereqs. Breezing → speed up, don't waste time. Material confusing (bad docs) → clearer explanation + note resource quality.
Step 4: Test — Check Understanding
Verify learning w/ application qs, not recall.
- Prediction: "What would happen if changed X?"
- Comparison: "How diff from Y learned earlier?"
- Application: "How use this to solve Z?"
- Debug: "This code has bug related to what we learned — spot it?"
- Celebrate correct answers specifically: "Yes — reason that works is..."
- Incorrect → explore reasoning: "Walk me thru your thinking"
- Never frame incorrect as failure → diagnostic info
→ Testing reveals working model vs surface recall. Working handles variations; surface can't. Collaborative, not exam.
If err: Can't answer application → learning too passive, need hands-on before more. Recall yes, application no → concepts individual but not integrated → focus connections.
Step 5: Adapt — Adjust Path
Based on tests + feedback → adjust.
- Easy milestone → combine w/ next, or deepen content
- Hard → break smaller, add prereq review
- Interest shifts → adjust to curiosity where possible — engagement drives retention
- Fatigued → break + review later vs push thru
- Teaching approach not working → diff modality (reading→doing, abstract→concrete)
- Update path + communicate: "Based on how this went, suggest adjust..."
→ Path evolves on real data. No fixed curriculum survives contact w/ actual learner — adaptation = value.
If err: Repeated adaptations still struggle → fundamental prereq gap missed in assessment → return Step 1, probe deeper. Losing motivation → discuss original goal — adjusting goal sometimes > changing path.
Step 6: Review — Consolidate + Plan Next
Solidify + setup continued learning.
- Summarize covered: "Today learned X, Y, Z"
- Ask person state key takeaway in own words
- Brief practice for indep work (not homework — optional reinforcement)
- Recommend 2-3 resources (docs, tutorials, examples)
- Spaced repetition → schedule reviews: "Review again in 2 days, then week"
- Next milestone: "Next time, tackle..."
- Ask feedback: "What worked? What diff?"
→ Person leaves w/ clear understanding of learned, practice, next. Clean closing, not abrupt stop.
If err: Can't state takeaway → covered too much / too little stuck. ID one concept most needing reinforcement + focus review. No motivation for indep practice → path more self-contained (all learning in sessions).
Check
- Starting position assessed before path designed
- Path has clear milestones ordered by dependency
- Material presented in small chunks w/ comprehension checks
- Testing used application qs, not just recall
- Path adapted ≥1 based on actual progress
- Session ended w/ summary, practice suggestion, next steps
- Person felt encouraged, not tested / judged
Traps
- Info dumping: All material at once vs pacing thru milestones. Overwhelm kills learning.
- Skip assessment: Assume level vs check. Frontend expert learning backend may know adjacent concepts but not ones you expect.
- Teach to average: Person faster / slower than expected → pace must change. Stick to plan despite feedback → wastes time / loses them.
- All theory, no practice: Understanding requires doing. Every milestone → practice element.
- Ignore motivation: Person doesn't see why matters → won't retain. Connect concepts to stated goal.
- Overload sessions: Too much one sitting. Less w/ retention > more w/ forgetting.
- Coach-as-lecturer: Coach guides exploration, doesn't monologue. More qs than answers.
→
learn— AI self-directed variant → systematic knowledge acquisitionteach-guidance— coach person to teach others; complementary to learning coachingmeditate-guidance— clear noise before learning → improves focus + retentionremote-viewing-guidance— shares structured observation supporting learning from experience
GitHub Repository
Verwandte Skills
content-collections
MetaDiese Skill bietet eine produktionsgetestete Einrichtung für Content Collections – ein TypeScript-first-Tool, das Markdown/MDX-Dateien in typsichere Datensammlungen mit Zod-Validierung umwandelt. Verwenden Sie ihn beim Erstellen von Blogs, Dokumentationsseiten oder inhaltsstarken Vite + React-Anwendungen, um Typsicherheit und automatische Inhaltsvalidierung zu gewährleisten. Er behandelt alles von der Vite-Plugin-Konfiguration und MDX-Kompilierung bis hin zur Deployment-Optimierung und Schema-Validierung.
polymarket
MetaDiese Fähigkeit ermöglicht es Entwicklern, Anwendungen mit der Polymarket-Prognosemärkte-Plattform zu erstellen, einschließlich API-Integration für Handel und Marktdaten. Sie bietet außerdem Echtzeit-Datenstreaming über WebSocket, um Live-Trades und Marktaktivitäten zu überwachen. Nutzen Sie sie zur Implementierung von Handelsstrategien oder zur Erstellung von Tools, die Live-Marktaktualisierungen verarbeiten.
creating-opencode-plugins
MetaDiese Fähigkeit unterstützt Entwickler dabei, OpenCode-Plugins zu erstellen, die in über 25 Ereignistypen wie Befehle, Dateien und LSP-Operationen eingreifen. Sie bietet die Plugin-Struktur, Event-API-Spezifikationen und Implementierungsmuster für JavaScript/TypeScript-Module. Nutzen Sie sie, wenn Sie den Lebenszyklus des OpenCode KI-Assistenten mit benutzerdefinierter ereignisgesteuerter Logik abfangen, überwachen oder erweitern müssen.
sglang
MetaSGLang ist ein hochperformantes LLM-Serving-Framework, das sich auf schnelle, strukturierte Generierung für JSON, Regex und agentenbasierte Workflows unter Verwendung seines RadixAttention-Prefix-Cachings spezialisiert. Es bietet deutlich schnellere Inferenz, insbesondere für Aufgaben mit wiederholten Präfixen, was es ideal für komplexe, strukturierte Ausgaben und Mehrfachdialoge macht. Wählen Sie SGLang gegenüber Alternativen wie vLLM, wenn Sie constrained decoding benötigen oder Anwendungen mit umfangreicher Präfix-Weitergabe entwickeln.
