# Feynman

Press a decision you just made until you can explain it to a skeptic in your own words...

- Repository: https://github.com/LilMGenius/paperthin (1365 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add LilMGenius/paperthin --skill feynman -g -a claude-code -y`
Codex: `npx skills add LilMGenius/paperthin --skill feynman -g -a codex -y`
Cursor: `npx skills add LilMGenius/paperthin --skill feynman -g -a cursor -y`
Gemini CLI: `npx skills add LilMGenius/paperthin --skill feynman -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

The rest: https://github.com/LilMGenius/paperthin/blob/HEAD/skills/depth/feynman/SKILL.md