Individual skill
feynman
Press a decision you just made until you can explain it to a skeptic in your own words, or surface the gap where you can't. The Feynman test aimed at a choice: understanding is cheapest to fake the moment after you decide, so a fresh critic presses for what you can't actually explain. Use right after picking an option, especially one an agent laid out without arguing for.
skills/depth/feynman/SKILL.md
Source commit 0b1e2c65231b3ce9294844362efae9b3a726e3ed
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Network or broad shell
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,383
- Repository last updated
- Nov 9, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- anti-slop Repository topic
- skills Repository topic
- evals Repository topic
- design-patterns Repository topic
- agent-skills Repository topic
- ai-agents Repository topic
- claude-code Repository topic
- codex Repository topic
- coding-agents Repository topic
- context-engineering Repository topic
- testing Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 4,180 bytes
Read excerpt
Press a decision you just made until you can explain it, or the gap where you can't is named.
## Goal
The moment after a choice is when understanding is cheapest to fake: you can restate an option fluently without having earned the reasons behind it, and by the time that gap matters the decision is load-bearing elsewhere. The Feynman test catches it — if you can't explain a thing plainly, you don't yet understand it. So no one hands you the rationale; a fresh critic that never made the decision presses for what you can't actually explain, and a shallow answer draws a narrower question instead of a pass. The result is a decision you can now explain under real pressure, or an honest flag that you can't yet.
## Workflow
1. **Trigger**: fire right after a decision is made — typically just after options were laid out with no argument for any, and one was picked.
2. **Restate, don't justify**: state the decision neutrally. Do not supply the reasoning behind it, and do not let the user borrow reasoning that was never actually given.
3. **Isolate the critic**: hand the decision — not any reasoning — to a fresh, context-free sub-session that never watched the decision get made. Have it press for gaps: what a skeptical outsider would ask, what is assumed but unstated, what would have to be true for the choice to hold.
4. **Return one gap at a time**: give the user the sharpest unresolved gap and ask them to explain it in their own words. Never batch gaps into a checklist.
5. **Judge the explanation**: if the answer actually resolves the gap, close it and move on. If it restates the question, deflects, or leans on authority ("the agent suggested it") instead of reasoning, do not accept it.
6. **Narrow, don't repeat**: on a shallow answer, don't ask the same question again — narrow to the exact part that stayed vague and ask that. Keep narrowing each round; never widen back to a generic "are you sure?"