deep-learn skill

A Claude Code skill that runs a Socratic, comprehension-gated learning session on a single topic. Claude acts as a patient expert teacher whose only goal is that the learner deeply understands the topic — not just the surface facts. Understanding is built incrementally, one stage at a time, and mastery of the current stage is confirmed before moving on. The session does not end until the learner has demonstrated understanding of every item on a running checklist.

features

• locks onto one specific topic per session (a concept, a file, a PR, an algorithm, a system)
• maintains a running markdown comprehension checklist with per-item mastery markers
• covers three pillars: the problem, the solution, and the broader context
• elicits the learner's current understanding first, then fills the gaps from there
• drills into why (and deeper why), not just what and how
• offers layered explanations on request: eli5, eli14, elii (explain like I'm an intern)
• quizzes with AskUserQuestion — randomized correct-answer position, answer hidden until submitted
• shows real code and suggests the debugger when it makes a concept concrete
• gates progression: never advances a stage until the current one is mastered
• ends only when every checklist item is verified — never declares mastery the learner hasn't shown

usage