Run a Feynman check
Reviews a learner's plain-language explanation of a concept, finds gaps, jargon used as a crutch and wrong steps, and asks targeted follow-up questions. Use to test real understanding.
Rereading creates a feeling of knowing that collapses the moment you have to explain. The Feynman technique exposes that: explain the idea simply, notice where you stall or reach for a technical word you cannot unpack, go back to the source, and try again. The useful feedback is precise about where the explanation breaks, not a model answer to copy.
Check this explanation of Only if [LEVEL] is given: at the level.
Before replying, privately write the essential chain of ideas a complete explanation at this level needs (usually 4 to 8 links), and the common misconceptions about the concept. Then compare the learner's explanation against it, looking for:
- Wrong: a statement that is false or a step that does not follow.
- Missing step: a link in the chain that is skipped, so the explanation jumps from cause to effect.
- Jargon crutch: a technical term doing the explaining without being explained ("the antigen triggers the immune response"). Test each technical term by asking whether the learner showed what it means.
- Vague or circular: words like "affects", "deals with" or "basically", or an explanation that restates the term ("inflation is when things inflate").
- Misconception: a known wrong model, even if phrased confidently.
- Unsupported example: an analogy or example that does not actually fit and would mislead.
Then:
- Name what holds up, specifically, quoting the learner's words.
- List each problem with the exact phrase it is in, its type, and why it matters for understanding. Order by importance; list at most 6.
- Ask 3 to 5 follow-up questions that target the weakest links. Each should be answerable in a sentence or two and should force the missing reasoning ("Why does the second exposure produce a faster response than the first?"), not invite a definition to be recited.
- Give one instruction for their next attempt: which part to look up again and which part to rewrite.
- Wait for their answers or their second attempt. When they reply, check again in the same way and say clearly when the explanation is complete and correct.
- Do not write a model explanation of the concept in the first reply; the learner's next attempt is the point. If they ask for one after a second attempt, give a concise one and point out what it has that theirs lacked.
- Do not invent errors. If the explanation is complete and correct for the level, say so and ask one stretch question about an edge case or application.
- Judge completeness at the stated level; do not mark a school explanation down for missing university detail.
- Correct factual errors clearly; do not soften a real misconception into "almost right".
What holds up
2 to 4 bullets quoting the learner.
Gaps
A table: Phrase | Problem type | Why it matters.
Follow-up questions
Numbered, 3 to 5.
Your next attempt
One or two sentences.
2 required values still a placeholder; the assistant will ask for them.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Learning and education
- category
- Studying
- level
- Beginner
- made for
- Student, Anyone, personal use
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install run-feynman-check --target claude-codenpx skills add hermes-hq/hodios-dist --skill run-feynman-check -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-education@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of StudyingBuild a concept map
Turns a topic or chapter into a concept map with labelled links and cross-links, as Mermaid or an outline, then quizzes the learner on the links. For students who know facts but miss connections.
build-concept-mapExplain a concept at a chosen level
Explains a concept at a chosen level, from child to expert, with an analogy, a worked example and one check-for-understanding question. Use when a textbook explanation is not landing.
explain-concept-at-levelQuiz me interactively
Runs an adaptive quiz one question at a time, adjusts difficulty to the learner's answers and ends with a summary of weak areas to review. Use for quick self-testing on any topic.
quiz-me-interactivelyStudy coach
Coaches learners on how to study, teaching retrieval practice and spacing, helping them plan and reflect, and holding them to small commitments. Use for ongoing study support.
study-coachSocratic tutor
Tutors by asking guiding questions and giving graded hints instead of answers, so the learner reaches the solution and can explain it. Use for studying, homework help and learning to code.
socratic-tutorAnalyse exam mistakes
Classifies the mistakes in marked work as knowledge gaps, misreads, slips, time pressure or method errors and builds a targeted review plan for each type. Use after getting work back.
analyze-exam-mistakes