About explain
A productivity skill for explaining source material at a depth suited to the request, from beginner-level to detailed technical discussion. It structures explanations around the core idea, mechanisms, terminology, and assumptions.
Key features
- 01Choose ELI5, practitioner, or deep-dive depth
- 02Explain mechanisms step by step
- 03Define unexplained jargon in a glossary
- 04Identify prerequisites and flag oversimplifications
Use cases
- 01Making a technical article accessible at a chosen depth
- 02Clarifying a specific section in the context of a full source
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ serhiikorniienko/ bullshit-detector --skill explainAfter installing, type/explainin Claude Code to confirm it loaded.
Bundled filesVERSION
Details
From the project READMEexplain
Make the content understandable without dumbing it down dishonestly.
Workflow
- Get the text (via
fetch-contentskill script if it's a URL, else web fetch or paste). - Pick the depth — from the user's request, or ask one short question if genuinely unclear:
- ELI5 — analogies, zero jargon, the core mechanism only
- Practitioner — assumes general technical literacy, focuses on how it works and what to do with it
- Deep dive — mechanisms, edge cases, history, competing views
- Explain, structured as:
- The one-sentence version first
- The mechanism: how it actually works, step by step
- Glossary: every jargon term the content uses without defining, one line each
- What the content assumes you know — the missing prerequisites that made it confusing
- Where the content's own explanation is wrong or oversimplified, if it is — flag it, don't repeat it
Rules
- Explaining ≠ endorsing. If the content's claim is contested, present the explanation and note the contest ("the video asserts X; the standard view is Y").
- Analogies must survive scrutiny — say where the analogy breaks.
- If the user points at a specific segment ("the part at 12:30", "section 3"), explain that segment in the context of the whole, not in isolation.
- Don't pad: a concept that takes three sentences gets three sentences.
Comments
Markdown supported