| name | teach-by-doing |
| version | 1.0.0 |
| description | Never teach a principle without an immediate rep. When designing ANY teaching content — a workshop, a lesson plan, a deck, a course module, a webinar, an explainer video, an educational post — pair every theoretical unit with an embodiment the learner does right now. Use whenever building or reviewing teaching material, lesson plans, workshop flows, course outlines, or training content, OR when the user says 'teach-by-doing', 'add an exercise', 'make it hands-on', 'don't leave it abstract', 'תרגיל לכל עיקרון', 'הטמעה מיידית'. |
teach-by-doing — no theory without a rep
The single rule: every theoretical teaching unit must be paired with an immediate embodiment.
No principle is "taught" until the learner did something with it — on the system, in the
interface, on paper, or in their own body and emotion. Abstract talk evaporates. A rep sticks.
This is a design-time skill: it runs while you build teaching material, not while you
deliver it. Its job is to make sure no principle ships naked.
Why (the research, in one breath)
- Kolb's experiential cycle closes only at active experimentation — and when you can't
test for real yet, you "make a plan for when and how." That fallback is the whole point.
Experiential methods lift retention up to ~75% vs. passive lecture.
- Generation effect: a learner who generates their own example remembers far more than
one handed a finished example — and generation pulls in personal experience and emotion as
retrieval cues. (So a writing/own-example rep beats a slide.)
- Embodied cognition: a motor action in the interface strengthens the learning signal and
primes recall. (So "open the tool and do step 1" beats "here's how it would work.")
Three different sciences, one instruction: make them do it now.
The ladder — pick the highest rung the moment allows
For each teaching unit, climb to the highest feasible rung. Never drop below rung 4.
| Rung | Use when | The rep | Anchor |
|---|
| 1 · Real embodiment | the action is doable today on the real system | Do it now on the live agent / computer / account. Real artifact, real feedback. | Kolb — concrete experience |
| 2 · Interface rehearsal | the real action is relevant weeks ahead (a slow process) | Open the interface and do a partial move — navigate, scaffold step 1, dry-run it. | Embodied cognition |
| 3 · Writing rep | can't touch the system at all | On paper / in a doc: generate your own example, fill a blank, write a commitment. | Generation effect |
| 4 · Activating rep | even writing doesn't fit | A felt decision, a visualization, a stated intention — move an emotional process. | Emotion as retrieval cue |
Rung 1 is the goal. Rungs 2–4 exist so a "you can't do this yet" principle is never an
excuse to stay abstract. A future-tense process still gets a present-tense rep.
What this skill does when you invoke it
You point it at teaching content (a plan, a deck, an outline, a draft). It:
- Segments the content into discrete teaching units — one principle / one small step each.
- Classifies each unit: is it implementable on the system today? → assign the highest
feasible rung.
- Generates a concrete rep for each — 2–5 minutes, specific, doable. Not "reflect on X"
but "open the tool and ask it Y" / "write your own Z in the notebook."
- Flags any unit with no rep as incomplete — a gate the material does not pass. If a
principle resists every rung, that is a signal the principle is too abstract to teach yet;
sharpen it or cut it.
Output: a table — principle → rung → rep → mental muscle — ready to drop into the
lesson plan. (See references/EXAMPLES.md for the canonical worked example.)
How to write a good rep
- Present tense, imperative, specific. "Ask your agent: what do you know about my
business, and what's missing?" — not "consider what the agent knows."
- Make it generate, not receive. The learner produces their own example, in their own
context. That is where the memory and the emotion live.
- One muscle per rep. Name the muscle ("rerouting everything to one source", "consulting
instead of commanding"). The name is half the learning.
- Keep it cheap. 2–5 minutes. A rep they skip because it's heavy teaches nothing.
- Sequence the reps into an arc, so the set tells a story (tour → redirect → furnish →
consult → make-it-mine), not a checklist of unrelated drills.
- Prefer doing over watching. A live demo by the teacher is rung 0 — it does not count.
The learner's own hands are the minimum.
The test before any teaching material ships
Walk every principle in the material. For each, can you point to the rep the learner does
in the moment? If even one principle is just words — it hasn't been taught yet.
