learn-guidance
À propos
Cette compétence de Claude agit comme un coach d'apprentissage IA pour guider les développeurs dans l'apprentissage structuré de nouvelles technologies ou compétences. Elle évalue les connaissances existantes, conçoit un parcours d'apprentissage personnalisé, accompagne à travers le matériel pédagogique et teste la compréhension avec une difficulté adaptative. Utilisez-la pour démarrer une nouvelle technologie, vous sentir submergé par la documentation, avoir besoin de répétition espacée pour la mémorisation, ou lors d'une transition de domaine nécessitant une analyse des écarts.
Installation rapide
Claude Code
Recommandénpx 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-guidanceCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
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
Dépôt GitHub
Compétences associées
content-collections
MétaCette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.
polymarket
MétaCette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.
creating-opencode-plugins
MétaCette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.
sglang
MétaSGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.
