{"id":17565,"plugin_id":"plugins_6a78e83987748191afc0c56e12172fce","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:14:15.897Z","digest":"0455f252d0bb8edf61771b4edad731bc26d52bef339a43fca38f866d31a26fd0","against":null,"payload":{"description":"Teach a technical concept interactively using the workspace as an active learning lab with durable learning records. Use when the user asks to understand a codebase concept, learn a language feature, explore design patterns, or practice coding skills — even if they say \"explain how this works to me\". Do NOT use for silent autonomous code generation.","included_files":[{"relative_path":"GLOSSARY-FORMAT.md","size_in_bytes":2122},{"relative_path":"LEARNING-RECORD-FORMAT.md","size_in_bytes":2747},{"relative_path":"MISSION-FORMAT.md","size_in_bytes":1540},{"relative_path":"RESOURCES-FORMAT.md","size_in_bytes":1924},{"relative_path":"agents/openai.yaml","size_in_bytes":96}],"name":"teach","skill_md_contents":"---\nname: teach\ndescription: \"Teach a technical concept interactively using the workspace as an active learning lab with durable learning records. Use when the user asks to understand a codebase concept, learn a language feature, explore design patterns, or practice coding skills — even if they say \\\"explain how this works to me\\\". Do NOT use for silent autonomous code generation.\"\n---\n\n# Teach\n\nTransform the current workspace into an interactive, stateful learning laboratory producing structured HTML lessons, reference materials, primary source bibliographies, and progressive learning records.\n\n---\n\n## Core Invariants\n\n1. **Mission-Grounded Curriculum**: Every lesson, quiz, and exercise must directly anchor to `MISSION.md` (the learner's explicit real-world objective).\n2. **Desirable Difficulty & Retrieval**: Target long-term storage strength through effortful retrieval, spaced practice, and interleaved exercises over fleeting in-the-moment fluency.\n3. **Beautiful HTML Artifacts**: Lessons are rendered as self-contained, publication-grade HTML documents in `./lessons/000X-<name>.html` styled via shared assets (`./assets/style.css`).\n4. **Durable Learning Records**: Capture key insights, non-obvious breakthroughs, and mental model shifts in `./learning-records/000X-<name>.md` to maintain the Zone of Proximal Development (ZPD).\n5. **Primary-Source Grounding**: Never rely purely on model memory; cite and link verified primary sources in `RESOURCES.md` and inline lesson annotations.\n\n---\n\n## Architecture & Map of Content (MOC)\n\n```\n[ Learner Request / Mission ] ──► [ Assess ZPD via Learning Records ] ──► [ Build HTML Lesson & Quizzes ] ──► [ Record Progress in Learning Records ]\n```\n\n| Component | Responsibility | File Location / Template |\n|---|---|---|\n| **Mission Anchor** | Core motivation and real-world goal | `MISSION.md` ([MISSION-FORMAT.md](MISSION-FORMAT.md)) |\n| **Lesson Artifacts** | Interactive HTML lesson modules | `./lessons/000X-<slug>.html` |\n| **Reference Sheets** | Cheat sheets, syntax summaries, and glossaries | `./reference/*.html` |\n| **Learning Records** | Milestone reflections and conceptual breakthroughs | `./learning-records/000X-<slug>.md` |\n| **Shared Assets** | Typography, styles, and interactive quiz widgets | `./assets/*` |\n| **Primary Sources** | Vetted documentation and book references | `RESOURCES.md` ([RESOURCES-FORMAT.md](RESOURCES-FORMAT.md)) |\n\n---\n\n## Step-by-Step Procedure (TWI)\n\n### Step 1: Establish Mission and Assess Zone of Proximal Development\n- **Action**: Check `MISSION.md` and existing `./learning-records/`. If uninitialized, grill the user to define their motivation and starting baseline.\n- **Key Point**: Frame teaching around what the user needs to *do* rather than abstract theory.\n- **Why**: Learning is significantly faster and more durable when grounded in immediate application.\n\n### Step 2: Source Primary References\n- **Action**: Identify and record the top primary source documentation or authoritative articles in `RESOURCES.md`.\n- **Key Point**: Ensure claims and code patterns conform to modern best practices.\n- **Why**: Citing primary sources builds user trust and teaches research habits.\n\n### Step 3: Author Interactive HTML Lesson\n- **Action**: Generate `./lessons/000X-<slug>.html` linking to `./assets/style.css`.\n- **Key Point**: Include interactive self-check questions, code snippets, and direct links to reference sheets.\n- **Inline Checklist**:\n  - [ ] Standalone HTML opens cleanly in browser\n  - [ ] Quiz answers formatted with balanced word/character counts\n  - [ ] Follow-up discussion prompts included\n\n### Step 4: Record Breakthroughs in Learning Records\n- **Action**: After the user interacts with the lesson, capture the key concepts mastered and areas for next practice in `./learning-records/000X-<slug>.md`.\n- **Why**: Keeps learning state synchronized across different sessions.\n\n---\n\n## Anti-Rationalization Guardrails\n\n| Tempting Rationalization | Binding Rule | Engineering Rationale |\n|---|---|---|\n| *\"Dump a 2000-word explanation directly into chat.\"* | **Package learning into modular HTML lessons and reference files.** | Chat text scrolls away; structured files provide a lasting personal library. |\n| *\"Give easy multiple-choice questions with obvious answers.\"* | **Enforce balanced, high-friction retrieval practice.** | Obvious answers create false fluency without building long-term memory. |\n| *\"Teach without checking `MISSION.md`.\"* | **Mandatory mission alignment for every lesson.** | Disconnected theory causes learner disengagement and rapid forgetting. |\n\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}