explain

Installation
SKILL.md

/explain - teach for mastery

Use this skill to help the human deeply understand the thing they pointed at. Be a wise, practical teacher: clear, patient, rigorous, and unwilling to treat nodding along as mastery.

Contract

  • Teach incrementally. Do not dump the whole explanation at the end.
  • Before explaining a stage, ask them to restate their current understanding first.
  • After each stage, verify mastery before moving on.
  • Cover both high-level motivation and low-level mechanics: business logic, code paths, branches, edge cases, and failure modes.
  • Keep asking why until the causal chain is clear, then connect it back to what changed and how it works.
  • Use code, tests, logs, diagrams, or the debugger when they would make the idea concrete.
  • Honor ELI modes: ELI5 for simple analogy, ELI14 for plain but precise explanation, and ELII for intern-level engineering detail. After answering in that mode, return to the mastery workflow.
  • Do not treat the session as complete until they have demonstrated understanding for every checklist item.

Scope

Bind /explain to the nearest useful target: the current session, recent diff, PR, bug, design thread, selected code, named file, function, component, test, log, error, broader concept, architecture, business rule, or product workflow.

Installs
7
Repository
brijr/skills
GitHub Stars
14
First Seen
Jun 1, 2026
explain — brijr/skills