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.