Purpose
Explain one thing, once, in genuinely plain words. The object can be a concept, a
piece of code, an error, an architecture, or the assistant's own previous output.
The core move is an altitude drop: land the explanation at the lowest useful
altitude first, a concrete analogy, zero jargon, then layer altitude back up
only when the user asks for it. The
Feynman technique is the method.
Use when: the user signals they didn't follow something, I don't get it,
explain simply, what does this actually mean, rephrase that. Skip
when: the user wants ongoing, multi-session coaching with persistent state (hand
off to /education:teach); a plain inline answer already lands (just answer).
This skill auto-invokes (no disable-model-invocation) because "I don't get it"
should reach it without the user naming a command. Auto-trigger is best-effort;
/education:explain is the guaranteed path.
The core move. Plain-language first pass
- Identify the object. With an argument, that is the thing. Empty argument →
the previous assistant response (see "Empty argument" below).
Done when you can name the object in one sentence, or, on a cold start
with no prior assistant message, have asked what to explain instead of
guessing.
- Ground it, don't recall it. Re-read the actual artifact this turn, the
message just sent, the file, the error text, the code. For an external concept,
fetch a primary source rather than leaning on parametric memory (plugin
doctrine: knowledge is grounded, not remembered).
Done when this turn's explanation cites a specific passage, file, error
text, or fetched primary source you re-read here. A recalled paraphrase does
not count.
- Drop to plain. One concrete analogy from everyday life. No jargon, no term
that itself needs prior knowledge. Short. If a technical word is unavoidable,
define it inline in ordinary words the first time.
Done when the explanation contains one everyday analogy whose structure
maps to the object, a "what it's actually doing" line, and no leftover term
that is not defined inline in ordinary words.
- Close with the handoff line (see "Handoff").
Done when the response ends with the single standard
/education:teach
invitation line.
Lead with the analogy and the "what it's actually doing," not with vocabulary.
Empty argument. Anaphora default
When invoked with no argument, the object is the assistant's own previous
response. The thing the user is reacting to. I don't get it needs no topic
named. Re-read that prior message, find the part most likely to have lost the
reader (the densest jargon, the biggest leap), and drop that to plain words.
Do not ask "explain what?" when the conversation makes the referent obvious. But
when there is no prior assistant message to resolve the anaphora against, a
cold start where the user opens the conversation with I don't get it and nothing
has been said yet, do not hallucinate a referent: ask "What would you like
explained?" instead of proceeding blind.
Altitude layering. On request only
Start at rung 1. Climb only when the user asks ("go deeper", "more precise", "I
actually know X"). Never front-load a higher rung.
| Rung |
Altitude |
Move |
| 1 (default) |
Plain |
Concrete everyday analogy, zero jargon. The floor and the default landing. |
| 2 (on request) |
High-school |
Introduce one or two real terms of art as vocabulary-ladder entries: the term, its definition in ordinary words, and one modeled "you can now say: …" sentence showing the term doing work in the user's own next prompt. Keep the analogy as scaffolding. |
| 3 (on request) |
Peer |
Full precision, jargon allowed, edge cases and tradeoffs, the explanation a colleague in the field would want. |
Offer the next rung as a one-line invitation, not a wall of text: "That's the plain
version, want the high-school one?"
Feynman gap check
The plain-language pass is a comprehension self-test, not a rewording service. If
you cannot shed the jargon, if the only "explanation" you can produce still
leans on the very terms the user didn't follow, or on hand-waving, that is a
detected understanding gap, on the explainer's side. Surface it honestly
rather than papering over it: name the specific part you cannot yet reduce and
why, and ground harder (re-read the source, fetch the primary reference) before
claiming to explain it. A confident-sounding restatement of jargon is the failure
mode this check exists to catch.
Success condition (original-ask invocations only)
When the explanation serves a task the user was stuck on, the success test is their next
prompt: it names what they mean in the newly plain terms instead of re-gesturing at the
confusion. Judge the explanation by that, and shape rung-2 vocabulary entries so the user can
reuse them. A bare comprehension ask with no task behind it ("I don't get it", full stop) has no
next-prompt contrast; this check does not apply there.
Handoff to education:teach
Close every explanation with a single lightweight line offering the multi-session
path, the first-party sibling in this same plugin:
Want to actually learn this, not just get past it? /education:teach topic <x>
runs a multi-session coached deep-dive.
One line, standard close. explain is one-shot; teach is the persistent,
mission-driven coach when the user wants ongoing depth or practice.
Gotchas
- Don't climb unasked. The default is rung 1. Delivering the peer-level
explanation first defeats the point, the user already didn't follow the
peer-level version.
- Anaphora referent is the assistant's output, not the user's. Empty
argument explains what the assistant just said, which the user is reacting to.
- Analogy must actually map. A decorative analogy that breaks under one step
of pressure is worse than none. Pick one whose structure mirrors the real thing.
- Ground before you simplify. Simplifying a fact you recalled wrongly produces
a confident, plain, wrong answer. Re-read or fetch first.
What this skill does NOT do
- Not multi-session coaching. No workspace, mission, glossary, or persistent
learning state. When the user wants ongoing tutoring, hand off to
/education:teach.
- Not
teach's explain action. /education:teach explain <concept> writes
a durable lesson into an active teach learning workspace. This skill,
/education:explain, is a standalone one-shot with no workspace. Namespacing
keeps them distinct; on "I don't get it" only this skill auto-fires
(teach sets disable-model-invocation).
- Not a rewording service. If the jargon can't be shed, that's a gap to
surface (Feynman gap check), not a synonym to swap in.
- Not a picture. This skill changes altitude and stays in prose. When the user
wants a visual explainer instead, a diagram rather than a paragraph, that is the
sibling
/education:eli5; invoke it via the Skill tool. Its floor is fixed at
zero prior knowledge and does not climb, which is the trade it makes for the
medium.
1---2name: explain3description: One-shot plain-language explainer. Drops any concept, code, error, architecture, or the previous assistant response to genuinely plain words (concrete analogy, zero jargon), then layers altitude up only on request (high-school, then peer level). Use when: 'I don't understand this', 'I don't get it', 'what does this actually do', 'what does this mean', 'explain simply', 'rephrase that'. Empty argument targets the previous assistant response (anaphora), so 'I don't get it' needs no topic named. This changes ALTITUDE, in PROSE. Trades precision for plain words; when the ask is instead to reorganize a dense message faithfully without losing precision, that is a STRUCTURE change, adhd:clarify (if installed), not an altitude drop. When the ask is for a picture (a diagram, a visual explainer, ELI5), that is a MEDIUM change, education:eli5. Sibling to education:teach. Hand off there for multi-session coaching; this is a single-shot check, not ongoing tutoring.4---56## Purpose78Explain one thing, once, in genuinely plain words. The object can be a concept, a9piece of code, an error, an architecture, or the assistant's own previous output.10The core move is an **altitude drop**: land the explanation at the lowest useful11altitude first, a concrete analogy, zero jargon, then layer altitude back up12**only when the user asks for it**. The13[Feynman technique](https://fs.blog/feynman-technique/) is the method.1415**Use when:** the user signals they didn't follow something, `I don't get it`,16`explain simply`, `what does this actually mean`, `rephrase that`. **Skip17when:** the user wants ongoing, multi-session coaching with persistent state (hand18off to `/education:teach`); a plain inline answer already lands (just answer).1920This skill auto-invokes (no `disable-model-invocation`) because "I don't get it"21should reach it without the user naming a command. Auto-trigger is best-effort;22`/education:explain` is the guaranteed path.2324## The core move. Plain-language first pass25261. **Identify the object.** With an argument, that is the thing. Empty argument →27 the **previous assistant response** (see "Empty argument" below).28 **Done when** you can name the object in one sentence, or, on a cold start29 with no prior assistant message, have asked what to explain instead of30 guessing.312. **Ground it, don't recall it.** Re-read the actual artifact this turn, the32 message just sent, the file, the error text, the code. For an external concept,33 fetch a primary source rather than leaning on parametric memory (plugin34 doctrine: knowledge is grounded, not remembered).35 **Done when** this turn's explanation cites a specific passage, file, error36 text, or fetched primary source you re-read here. A recalled paraphrase does37 not count.383. **Drop to plain.** One concrete analogy from everyday life. No jargon, no term39 that itself needs prior knowledge. Short. If a technical word is unavoidable,40 define it inline in ordinary words the first time.41 **Done when** the explanation contains one everyday analogy whose structure42 maps to the object, a "what it's actually doing" line, and no leftover term43 that is not defined inline in ordinary words.444. **Close with the handoff line** (see "Handoff").45 **Done when** the response ends with the single standard `/education:teach`46 invitation line.4748Lead with the analogy and the "what it's actually doing," not with vocabulary.4950## Empty argument. Anaphora default5152When invoked with no argument, the object is the **assistant's own previous53response**. The thing the user is reacting to. `I don't get it` needs no topic54named. Re-read that prior message, find the part most likely to have lost the55reader (the densest jargon, the biggest leap), and drop *that* to plain words.56Do not ask "explain what?" when the conversation makes the referent obvious. But57when there is **no prior assistant message** to resolve the anaphora against, a58cold start where the user opens the conversation with `I don't get it` and nothing59has been said yet, do not hallucinate a referent: ask "What would you like60explained?" instead of proceeding blind.6162## Altitude layering. On request only6364Start at rung 1. Climb only when the user asks ("go deeper", "more precise", "I65actually know X"). Never front-load a higher rung.6667| Rung | Altitude | Move |68|------|----------|------|69| 1 (default) | **Plain** | Concrete everyday analogy, zero jargon. The floor and the default landing. |70| 2 (on request) | **High-school** | Introduce one or two real terms of art as vocabulary-ladder entries: the term, its definition in ordinary words, and one modeled "you can now say: …" sentence showing the term doing work in the user's own next prompt. Keep the analogy as scaffolding. |71| 3 (on request) | **Peer** | Full precision, jargon allowed, edge cases and tradeoffs, the explanation a colleague in the field would want. |7273Offer the next rung as a one-line invitation, not a wall of text: "That's the plain74version, want the high-school one?"7576## Feynman gap check7778The plain-language pass is a comprehension self-test, not a rewording service. If79you **cannot** shed the jargon, if the only "explanation" you can produce still80leans on the very terms the user didn't follow, or on hand-waving, that is a81detected understanding gap, on the explainer's side. **Surface it honestly**82rather than papering over it: name the specific part you cannot yet reduce and83why, and ground harder (re-read the source, fetch the primary reference) before84claiming to explain it. A confident-sounding restatement of jargon is the failure85mode this check exists to catch.8687## Success condition (original-ask invocations only)8889When the explanation serves a task the user was stuck on, the success test is their **next90prompt**: it names what they mean in the newly plain terms instead of re-gesturing at the91confusion. Judge the explanation by that, and shape rung-2 vocabulary entries so the user can92reuse them. A bare comprehension ask with no task behind it ("I don't get it", full stop) has no93next-prompt contrast; this check does not apply there.9495## Handoff to `education:teach`9697Close every explanation with a single lightweight line offering the multi-session98path, the first-party sibling in this same plugin:99100> Want to actually learn this, not just get past it? `/education:teach topic <x>`101> runs a multi-session coached deep-dive.102103One line, standard close. `explain` is one-shot; `teach` is the persistent,104mission-driven coach when the user wants ongoing depth or practice.105106## Gotchas107108- **Don't climb unasked.** The default is rung 1. Delivering the peer-level109 explanation first defeats the point, the user already didn't follow the110 peer-level version.111- **Anaphora referent is the *assistant's* output, not the user's.** Empty112 argument explains what the assistant just said, which the user is reacting to.113- **Analogy must actually map.** A decorative analogy that breaks under one step114 of pressure is worse than none. Pick one whose structure mirrors the real thing.115- **Ground before you simplify.** Simplifying a fact you recalled wrongly produces116 a confident, plain, wrong answer. Re-read or fetch first.117118## What this skill does NOT do119120- **Not multi-session coaching.** No workspace, mission, glossary, or persistent121 learning state. When the user wants ongoing tutoring, hand off to122 `/education:teach`.123- **Not `teach`'s `explain` *action*.** `/education:teach explain <concept>` writes124 a durable lesson into an active `teach` learning workspace. This skill,125 `/education:explain`, is a standalone one-shot with no workspace. Namespacing126 keeps them distinct; on "I don't get it" only this skill auto-fires127 (`teach` sets `disable-model-invocation`).128- **Not a rewording service.** If the jargon can't be shed, that's a gap to129 surface (Feynman gap check), not a synonym to swap in.130- **Not a picture.** This skill changes altitude and stays in prose. When the user131 wants a visual explainer instead, a diagram rather than a paragraph, that is the132 sibling `/education:eli5`; invoke it via the Skill tool. Its floor is fixed at133 zero prior knowledge and does not climb, which is the trade it makes for the134 medium.