← Matt Skills CuratedCONTENT HISTORY

Update to Matt Skills Curated

Snapshot Sep 30, 2026 · 23:14 UTC · version 1.1.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "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"
}

SHA-256 of public snapshot: 0455f252d0bb8edf61771b4edad731bc26d52bef339a43fca38f866d31a26fd0