MCPInstall

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.

Installs
1.2K
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/lilmgenius/paperthin --skill feynman
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads feynman automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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?"
  7. Stop condition: after repeated rounds, either every gap is genuinely explained, or one isn't. Both are valid endings.
  8. On an unexplained gap: don't force a resolution or let the user paper over it. Name the unresolved point specifically and flag the decision for re-review — not a verdict that it was wrong, only that it isn't yet earned.

Rules

  • Never supply the rationale before the user attempts one. Handing reasoning over first is the frame-injection failure this skill exists to avoid.
  • The pressing comes from an isolated sub-session, never self-assessed in the session that made the choice — a mind can't un-know the decision it just made, any more than an author can un-know their own draft.
  • Narrow, don't repeat. A second identical question teaches the user to restate louder; a narrower one tests whether the gap actually closed.
  • Never force a resolution. An honestly unexplained gap is a usable result — a signal the decision needs another look — not a failure of the skill.
  • User-invoked on purpose: a challenge-every-decision reflex always in reach would bias the user toward chronic self-doubt. It fires only when deliberately reached for.

Verification

  1. Compare the user's first answer to a gap against their answer after narrowing — the round-over-round change in what they can actually explain is the real signal, not merely that no more objections came up.
  2. Every closed gap traces to an explanation that resolved the actual question, not one that restated it.
  3. Any gap still open is named specifically — which assumption, not a vague "the user struggled" — and carried forward as a flag on the decision, never silently dropped.
  4. The rationale was never supplied by this skill; every reason that closed a gap came from the user.

FAQ

What does the feynman skill do?

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.

How do I install feynman?

Run npx skills add https://github.com/lilmgenius/paperthin --skill feynman in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feynman/ (personal) or .claude/skills/feynman/ (project).

Which AI agents can use feynman?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is feynman safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains feynman?

It is published by lilmgenius in lilmgenius/paperthin. It has 1,218 recorded installs.

More from lilmgenius/paperthin

View all →

dedash

lilmgenius/paperthin

Remove em-dashes and the dashes standing in for them from a user-owned scope, reading each occurrence in context and choosing the punctuation or wording that fits.

1.5K installs

ssotize

lilmgenius/paperthin

Audit and consolidate a fact that's scattered across places into one canonical source, after approval, and replace the rest with references. Use when asked to find duplication, check consistency, locate the source of truth, deduplicate, consolidate, unify, or establish SSOT across artifacts or platforms. Starts read-only, reports the map and plan, then mutates only after explicit approval.

Backend & APIs1.3K installs

shower

lilmgenius/paperthin

Cold-read the artifact you're focused on from a fresh, zero-context sub-session to confirm it stands on its own — a shower-thought reset for accumulated session bias. Use when a long session has worn away your fresh eyes and you can no longer tell whether the artifact in focus is clear to someone with no prior context; before a handoff, publish, or merge; or when you want a clean-room comprehension smoke test. Spawns a separate context-free reviewer; it diagnoses, it does not fix.

Testing & QA1.3K installs

hate

lilmgenius/paperthin

Attack a plan, design, or argument like you want it to fail before you commit real effort — return the single load-bearing objection and the cheapest experiment that would prove it matters, not a checklist. User-invoked on purpose: a hate-it reflex always in the agent's reach would bias it toward demolition. Weighs many failure axes but owns the synthesis to one root.

factchk

lilmgenius/paperthin

Verify reality-grounded claims against external sources in both directions before they ship — could the 'absurd' be real, could the 'obvious' be false or long-established? Use whenever an artifact, or the sentence you are about to write, asserts something as plausible, realistic, absurd, novel, or impossible from intuition rather than a checked source; before relying on a factual claim in prose, a design rationale, a research claim, or a plan. Fires on metacognitive doubt — when you can't actually know, verify instead of trusting the feeling. Scans read-only, then fixes the clear errors or flags the judgment calls; leaves deliberate fiction alone.

re0

lilmgenius/paperthin

Refresh an existing artifact into the current best v0. Use when the user asks to clean up, sync up, dedupe, de-noise, smooth, rewrite, or update an artifact after iteration; when nearby artifacts may have drifted; or when changes in one place should be reflected across related artifacts while keeping the result minimal.

1.3K installs

Popular testing & qa skills

View category →

tdd

mattpocock/skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Testing & QA1.2M installs

grilling

mattpocock/skills

Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.

Testing & QA996.2K installs

migrate-to-shoehorn

mattpocock/skills

Migrate test files from as type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace as in tests, or needs partial test data.

Testing & QA484.1K installs

run-train

lllllllama/rigorpilot-skills

Rigor Train skill for deep learning research repositories. Use when a documented or selected training command should be run conservatively for startup verification, short-run verification, full kickoff, or resume, with command, config, seed, log, checkpoint, status, and metric evidence written to standardized trainoutputs/. Do not use for environment setup, exploratory sweeps, speculative idea implementation, or end-to-end orchestration.

Testing & QA337.8K installs

test-driven-development

obra/superpowers

Use when implementing any feature or bugfix, before writing implementation code

Testing & QA261.8K installs

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work

Testing & QA216.8K installs