Install
openclaw skills install @deciqai/feynman-techniqueActivate when: user says 'explain this simply', 'teach me like I'm five', 'do I really understand this', 'what's the simplest way to think about X', 'what's missing in my model', wants to test genuine vs. surface understanding of a concept, or is preparing to teach/present and needs to verify their mental model. Do NOT activate when: user needs a fast decision on a concept already well-tested, or the concept is irreducibly formal (legal statutes, certain proofs) where simplification destroys essential content.
openclaw skills install @deciqai/feynman-techniqueThe Feynman Technique tests whether understanding is genuine (can reproduce, predict, extend) or surface (can recognize, recall jargon). It exploits a cognitive asymmetry: recognizing an explanation is much easier than reproducing it. Feynman's principle: "The first principle is that you must not fool yourself — and you are the easiest person to fool."
Compose with neighbors: first-principles supplies the ground-level understanding Feynman Technique then tests. metacognition monitors your thinking process; Feynman Technique stress-tests the output. critical-thinking evaluates someone else's claimed understanding.
When NOT to use: Fast decision on a concept already tested; concept too new with no source material for Step 3; concept irreducibly formal — use first-principles instead; evaluating creativity or judgment, not understanding.
In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
Four steps producing a Feynman Understanding Audit. Stop rule: complete when explanation is genuinely plain — not when jargon is replaced with different jargon. If you cannot simplify further without factual loss, name the irreducible core.
Feynman Understanding Audit: <concept>
Initial Explanation: <verbatim, unedited>
Gap Diagnosis: location | type (circular/jargon/unjustified/hedge) | specific question I cannot answer
Sources consulted per gap: gap → source → what it clarified
Refined Explanation: <revised>
Analogies: analogy | works when | breaks down when
Summary: genuine (can reproduce/predict/extend) | surface only | irreducible core
→ Method in Action: Feynman and the Challenger O-Ring Investigation (1986)
| Domain | Surface recognition | Genuine understanding |
|---|---|---|
| Tech/engineering | Correct acronym use without explaining what problem each solves | Can predict failure modes and tradeoffs |
| Finance/investing | Fluent "DCF," "beta," "convexity" without explaining why formulas break down | Can explain to a non-finance person; spots when standard formulas give wrong answers |
| Leadership | Fluent framework use without explaining what behavior change each produces | Describes a concrete situation where each predicts a specific outcome |
Contribute a Feynman Audit Pack: one file cataloguing the top 5–10 surface-recognition patterns and what genuine understanding looks like.
→ Primary sources: references/sources.md
[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.
| Fake move | Reality |
|---|---|
| [D] "I know what it means, I just can't explain it simply." | This is the definition of surface recognition. If you understand it, you can explain it simply. |
| [D] Replacing jargon with different jargon. | "Capital allocation efficiency" for "return on investment" is not simplification. Test: can someone with no domain background follow it? |
| [D] Producing a correct-sounding analogy that predicts nothing. | An explanation producing no testable predictions has not conveyed genuine understanding. |
| [D] Treating it as a communication exercise. | The goal is to find where you cannot explain — not to produce a good explanation. |
| [D] Stopping when the explanation "sounds good." | A fluent jargon-reduced explanation ≠ genuine plain-language explanation. Test: does it predict outcomes and failure modes? |
| [D] Filling gaps with a secondary summary that has the same gap. | If you still cannot explain Y after reading "X works by doing Y," the gap is still open. Chase to a primary source. |
| [D] Accepting "it's complicated" as a valid stopping point. | It is never a conclusion — it is the beginning of gap diagnosis. |
| [D] Using the technique on too large a topic. | Identify the smallest falsifiable unit: a mechanism, a principle, a formula's derivation. |
| → Add [O] entries here after each real use — paste the actual failure pattern | What went wrong and why |
Part of deciqAI Knowledge Skills — open-source thinking skills that make rigor executable for AI agents. Built by deciqAI · https://deciqai.com · Contributions welcome — see the template at the repo root.