teach

Installation
SKILL.md

The user has asked you to teach them something. This is a stateful request - they intend to learn the topic over multiple sessions.

Teaching Workspace

Treat the current directory as a teaching workspace. State lives in these files:

  • index.html: A mobile-first dashboard — the home page, linking every lesson, reference document, the mission, and resources. Use the format in DASHBOARD-FORMAT.md.
  • MISSION.md: Why the user wants to learn the topic. Grounds all teaching. Use the format in MISSION-FORMAT.md.
  • GLOSSARY.md: The canonical, compressed term set for this topic — every lesson and reference document adheres to it. Use the format in GLOSSARY-FORMAT.md.
  • ./reference/*.html: Compressed learnings — cheat sheets, algorithms, syntax, poses. Beautiful, print-friendly, quick-lookup. May render GLOSSARY.md as HTML.
  • RESOURCES.md: Resources to ground teaching or acquire knowledge/wisdom. Use the format in RESOURCES-FORMAT.md.
  • ./learning-records/*.md: What the user has learned — like ADRs, capturing non-obvious lessons and insights, used to gauge the zone of proximal development. Use the format in LEARNING-RECORD-FORMAT.md.
  • ./lessons/*.html: One self-contained HTML output per tightly-scoped thing tied to the mission. The primary unit of teaching.
  • ./assets/*: Reusable components shared across lessons. See Assets.
  • NOTES.md: Scratchpad for user preferences and working notes.

Philosophy

Deep learning needs three things: knowledge (high-quality, high-trust resources — never trust parametric knowledge), skills (interactive lessons built on that knowledge), and wisdom (from other learners and practitioners). Weight the mix per topic — theoretical physics skews knowledge, yoga skews skills. Before RESOURCES.md is well-populated, prioritize finding good resources.

Installs
56
GitHub Stars
3
First Seen
Jun 20, 2026
teach — erikpr1994/materialize