From agent-almanac
Guides structured learning of new technologies, skills, or topics as a coach: assesses knowledge, designs paths, teaches material, tests understanding, adapts based on feedback, and plans spaced repetition reviews.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Delivers structured multi-session tutoring for technical topics with Socratic diagnostics, knowledge graphs for prerequisites, agendas, teaching, quizzes, and progress tracking.
Generates researched, module-based learning plans for technical or general topics. Saves plans and quiz progress to ~/.claude/learning/ directories. Resumes existing plans with status.
Teaches concepts adaptively: assesses learner level, scaffolds from known to unknown using Zone of Proximal Development, employs Socratic questioning, adapts to feedback. For 'how does X work?' queries revealing gaps or failed prior explanations.
Share bugs, ideas, or general feedback.
Guide a person through a structured learning process for a new topic, technology, or skill. The AI acts as a learning coach — helping assess starting knowledge, plan a study path, walk through material at the right pace, test understanding with questions, adapt the approach based on feedback, and consolidate for retention.
meditate-guidance has cleared mental noise, creating space for focused learningBefore designing a learning path, understand where the person currently stands.
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 │
└───────────────┴────────────────────────────┴──────────────────────────┘
Expected: A clear picture of the person's starting position, goal, and constraints. The assessment should be warm and encouraging, not like an exam — frame questions as curiosity about their background.
On failure: If the person cannot articulate their current level, ask them to describe a recent attempt to use or understand the topic. Concrete stories reveal level more accurately than self-assessment. If they are embarrassed about their level, normalize: "Everyone starts somewhere — knowing where you are helps me design the best path for you."
Create a structured path from their current position to their goal.
Expected: A learning path the person can see and understand. It should feel manageable — not overwhelming. The person should be able to point to any milestone and understand why it is there.
On failure: If the path feels too long, the goal may be too ambitious for the available time — discuss scope reduction. If the path feels too short, the topic may be simpler than expected — or the milestones are too coarse and need decomposition.
For each milestone, guide the person through the material at the right pace.
Expected: The person progresses through the material with comprehension, not just exposure. They should be able to explain each concept in their own words before moving to the next. The pace feels right — not rushed, not dragged.
On failure: If they are struggling, slow down and check for missing prerequisites. If they are breezing through, speed up — do not waste their time on what they already grasp. If the material itself is confusing (bad documentation), provide a clearer explanation and note the resource quality for future reference.
Verify learning with questions that require application, not just recall.
Expected: The testing reveals whether the person has a working mental model or surface-level recall. Working models can handle variations; surface recall cannot. The testing should feel like a collaborative exercise, not an exam.
On failure: If the person cannot answer application questions, the learning was too passive — they need hands-on practice before more material. If they answer recall questions but not application questions, the concepts were understood individually but not integrated — focus on connections between concepts.
Based on test results and the person's feedback, adjust the learning path.
Expected: The learning path evolves based on real data. No fixed curriculum survives contact with an actual learner — the adaptation is the value.
On failure: If repeated adaptations still leave the person struggling, there may be a fundamental prerequisite gap that was not caught in assessment. Return to Step 1 and probe deeper. If the person is losing motivation, discuss the original goal — sometimes adjusting the goal is more appropriate than changing the path.
Solidify what was learned and set up for continued learning.
Expected: The person leaves with clear understanding of what they learned, what they can practice, and what comes next. The session has a clean closing, not an abrupt stop.
On failure: If the person cannot state a key takeaway, the session covered too much or too little stuck. Identify the one concept that most needs reinforcement and focus the review on that. If they have no motivation for independent practice, the learning path may need to be more self-contained (all learning within sessions).
learn — the AI self-directed variant for systematic knowledge acquisitionteach-guidance — coaching a person to teach others; complementary to learning coachingmeditate-guidance — clearing mental noise before a learning session improves focus and retentionremote-viewing-guidance — shares the structured observation approach that supports learning from experience