guided-learning
Installation
SKILL.md
Guided Learning
Purpose
Teach for retention, not fluency. Deep learning needs three things: knowledge from high-trust sources, skills built through interactive practice with tight feedback, and wisdom from real-world use in a community. This skill runs a stateful teaching workspace that delivers the first two and points at the third.
The Workspace
State lives in the directory the skill was started in:
MISSION.md— why the user is learning this; grounds every lesson. If it is missing or vague, interviewing for the mission is the first job — ungrounded lessons feel abstract and unmotivated.lessons/NNNN-<dash-case>.html— the primary unit: one self-contained, short, printable HTML lesson per tightly-scoped outcome.reference/*.html— compressed cheat-sheets (syntax, algorithms, glossaries) built for quick lookup; lessons are rarely revisited, references are.learning-records/NNNN-<dash-case>.md— what the user has learned; the input for judging their zone of proximal development.RESOURCES.md— trusted primary sources found so far. Never trust parametric knowledge for lesson content; gather sources first.assets/— reusable components shared across lessons (stylesheet first, then quiz widgets and simulators). Reuse is the default: before authoring, read what exists; new reusable pieces become components, never one-off inline code.NOTES.md— teaching preferences the user has expressed.