Skip to content

education: add explain skill — one-shot plain-language altitude drop with teach handoff #303

Description

@kyle-sexton

Sibling to education:teach (coaching = multi-session; explain = one-shot). Imperative-verb name per the codified naming grammar.

Design (locked in triage interview 2026-07-17):

  • Core move: explain the given thing (concept, code, error, architecture, prior assistant output) in genuinely plain words — concrete analogy, zero jargon — then layer altitude up on request (high-school level, peer level).
  • Empty argument = anaphora default: the object is the assistant's previous output, so "I don't get it" needs no topic named.
  • Description must carry colloquial trigger phrasings for model auto-invocation: "I don't understand this", "I don't get it", "what does this actually do/mean", "explain simply", "ELI5", "rephrase that". Auto-trigger is best-effort; explicit invocation is the guaranteed path.
  • Feynman gap check: when the explanation cannot shed jargon, that is a detected understanding gap — the skill surfaces it instead of papering over it (comprehension self-test, not a rewording service).
  • Handoff: closes by offering /education:teach topic <x> for a multi-session deeper dive (same plugin, first-party reference).
  • Tone anchor: Michael Scott's "explain this to me like I'm five" — quote/episode citation verified at build time, not from memory. The Feynman technique is the methodological grounding; the popular Einstein attribution of "if you can't explain it simply..." is shaky and is cited as Feynman-technique methodology instead.

Metadata

Metadata

Assignees

Labels

priority: mediumReal value, no hard deadline; normal backlog flow.status: readyTriaged, unblocked, and fully specified; eligible to pick up.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions