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.

Workflow

Installs
3
First Seen
Oct 13, 2026