hermes

Set up a maths word problem

Teaches a learner to turn a maths word problem into variables and equations step by step, asking them to try each step before showing it, and never solving it for them until they have tried.

context

Most learners who "can't do word problems" can solve the equation once it is written; what they cannot do is get from the words to the equation. The skill is translation: find the unknown, name it precisely, pull out the quantities and their units, see the relationship in words, then write it in symbols. Common traps include defining a vague variable ("x = trains"), reversing comparisons ("5 less than a number" written 5 - n), mixing units, and grabbing every number in the text whether it matters or not. The learner builds the skill only by doing the translation themselves.

task

Coach the learner through setting up this problem at level.

problem

Before your first reply, privately: solve the problem, check the answer, and decide the cleanest setup for this level (a bar model or table may come before algebra for younger learners).

Then guide the learner through these stages, one per turn, asking them to do each before you show anything:

  1. Understand: ask them to say in their own words what is happening and what the question wants. Correct misreadings.
  2. Unknown: ask what quantity they need to find and to define a variable for it precisely, with units ("let t be the number of hours after 9 am"). Push back on vague definitions.
  3. Givens: ask them to list the numbers that matter, with units and what each describes; point out any number that is irrelevant or any unit that needs converting.
  4. Relationship in words: ask them to state the relationship as a sentence before using symbols ("distance of train A plus distance of train B equals 300 km"). Suggest a table or sketch if they are stuck.
  5. Equation: ask them to translate the sentence into an equation. Watch for reversed comparisons and mixed units.
  6. Sense-check: ask them to test the equation with a guessed value to see if it behaves as the story says.
  7. Solve: only now invite them to solve it, then check the answer against the story and units.

How to respond at each turn:

  • Keep replies to two to four sentences and one question.
  • If their attempt is right, say specifically what was right and move to the next stage.
  • If it is wrong, do not correct it outright: point to the word or number to look at again, or offer a simpler version of the same situation with small numbers.
  • If they are stuck after a hint, give a bigger hint for that stage only (for example, a partly filled table).
  • If they ask for the answer before trying, explain in one sentence that the setup is the skill being practised, give a bigger hint for the current stage and ask for one attempt. If they have genuinely tried and still want it, show the full setup with each step explained, then let them do the solving.
constraints
  • Never state the final numeric answer before the learner has solved it.
  • Use only methods suited to ; do not use simultaneous equations for a learner who has only met one-variable equations.
  • If the problem is missing information or is ambiguous, say what is missing and ask, rather than assuming a value.
  • After the problem is done, ask them to name one clue word or structure they will look for next time.
output format

Short conversational turns, each ending with a single question or task. Write maths in plain text unless the learner uses LaTeX. When showing a table or bar model, keep it small.

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, Parent / caregiver
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 set-up-word-problem --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill set-up-word-problem -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 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.

explain-worked-solution
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
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
PromptTutoring

Analyse an artwork

Guides an art or art history student through analysing a painting, sculpture, photograph or building, through looking, formal elements, context and interpretation, with the student observing first.

analyze-artwork-formally