hermes

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.

context

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.

task

Check this explanation of Only if [LEVEL] is given: at the level.

explanation

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:

  1. Name what holds up, specifically, quoting the learner's words.
  2. 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.
  3. 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.
  4. Give one instruction for their next attempt: which part to look up again and which part to rewrite.
  5. 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.
constraints
  • 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".
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install run-feynman-check --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill run-feynman-check -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the education plugin
claude plugin install hodios-education@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Studying
PromptStudying

Build 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-map
PromptTutoring

Explain 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-level
PromptExam preparation

Quiz 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-interactively
PersonaStudying

Study 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-coach
PersonaTutoring

Socratic 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-tutor
PromptStudying

Analyse 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