hermes

Explain a worked solution

Explains a worked solution to a maths or science problem step by step, why each step is taken and the idea it uses, flags any error, and sets a similar problem to try next.

context

Students often have the answer to a problem, from a mark scheme or a textbook, and still cannot see how anyone would think of it. Worked solutions show what was done but rarely why that step, at that moment: the decision behind it. Learning from worked examples works when each step is linked to the principle it uses and the cue in the problem that triggers it, and when the learner then tries a similar problem on their own.

task

Explain the solution to this problem for a learner at level.

problem

Only if [SOLUTION] is given:

solution

  1. Check the solution. Work the problem yourself and verify the answer by an independent route (substitution, units, an estimate, a limiting case). If a solution was supplied and it contains an error or an unjustified step, say exactly where and what the correct step is before explaining anything. If no solution was supplied, write your own clear solution and say it is yours.
  2. Break the solution into steps a learner at this level would recognise (merge trivial algebra; split steps that hide a decision).
  3. For each step, explain three things: what is done; why this step now, meaning the cue in the problem or the previous line that tells you to do it; and the idea, law or rule it uses, named in terms the learner will meet at their level.
  4. Name the key idea: the one step or insight that unlocks the problem, and how to spot problems that need it.
  5. List the two or three mistakes students commonly make on this kind of problem and how the solution avoids them.
  6. Write one similar problem that uses the same key idea in a different surface form (different context or numbers, same structure). Do not give its answer; offer to check the learner's attempt.
constraints
  • Use only methods and notation appropriate to . If the supplied solution uses a method beyond that level, explain it gently and mention the method the learner is expected to use.
  • Never explain an incorrect step as if it were correct.
  • Keep each step's explanation to two or three sentences. Write maths in the notation the problem uses (plain text or LaTeX).
  • If the problem is missing information needed to solve it, say what is missing and stop.
output format

Check

One line: the solution is correct, or where it goes wrong and the fix. Say if the solution is your own.

Step by step

A table: Step | What happens | Why this step now | Idea used.

The key idea

2 to 3 sentences.

Where people go wrong

Bullets.

Try this next

The new problem, then: "Send me your attempt and I'll check it."

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
Tutoring
made for
Student
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-03
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 explain-worked-solution --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill explain-worked-solution -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 Tutoring
PromptTutoring

Hint me through a problem

Tutors a learner through a maths or science problem with progressive hints, one at a time, and reveals the full solution only on request. Use when stuck on homework or practice.

hint-through-problem
PromptTutoring

Check my reasoning

Reviews a learner's worked solution or argument step by step, locates the first wrong step and asks a guiding question instead of giving the answer. Use to find your own mistake.

check-my-reasoning
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
PersonaTutoring

Math tutor

Acts as a patient mathematics tutor who finds the misconception behind an error, uses multiple representations and guides learners to answers instead of handing them over.

math-tutor
PersonaTutoring

Science tutor

Acts as a physics, chemistry and biology tutor who starts from the learner's mental model, uses diagrams, units and estimation, and fixes misconceptions with thought experiments.

science-tutor
RuleTutoring

Academic integrity rules

Standing rules that keep an assistant within academic integrity. It explains, hints and gives feedback but does not complete graded work or write submissions, and says so kindly.

academic-integrity-rules