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.
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.
Explain the solution to this problem for a learner at level.
Only if [SOLUTION] is given:
- 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.
- Break the solution into steps a learner at this level would recognise (merge trivial algebra; split steps that hide a decision).
- 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.
- Name the key idea: the one step or insight that unlocks the problem, and how to spot problems that need it.
- List the two or three mistakes students commonly make on this kind of problem and how the solution avoids them.
- 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.
- 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.
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
use in
npx @hermes-hq/hodios install explain-worked-solution --target claude-codenpx skills add hermes-hq/hodios-dist --skill explain-worked-solution -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 TutoringHint 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-problemCheck 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-reasoningExplain 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-levelMath 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-tutorScience 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-tutorAcademic 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