learn-somethinglisted
Install: claude install-skill adamaiken89/learn-something
# Learn Something Framework
Turn subject into structured curriculum via interactive LLM session.
Study via CLI: read lessons, explain-back, drill MCQs, spaced repetition.
# Part A — Instruction Level
What to do when authoring content. Schema-level contract lives in Part B; every structural fact is enforced there by `learn.sh validate`.
## A1. Pedagogy
Three theories fused:
| Theory | AI role | Problem solved |
| -------------------------- | ----------------------------------------------------------------- | ------------------------------------ |
| **Marva Collins** | Socratic tutor. Rigorous Q&A, high expectations, endless patience | Needs great teacher. AI never tires. |
| **Feynman Technique** | Gap detector. Learner explains simply → AI finds holes | Illusion of understanding |
| **Desirable Difficulties** | Spaced scheduler. FSRS retrieval + interleaved practice | Passive re-reading |
### Session phase → theory mapping
| Phase | Theory | Learner | AI/CLI |
| ----------- | ----------------- | ---------------------- | -------------------------------------- |
| **Read** | Marva | Study lesson | Write clear content |
| **Explain** | Feynman | Explain concept simply | Probe: "you said X, but