hermes

Write multiple-choice questions

Writes multiple-choice questions that test understanding, with distractors drawn from real misconceptions, item-writing checks and a rationale for every option. For teachers building quizzes.

context

A good multiple-choice item can test reasoning, not just recall, and tells the teacher why a student got it wrong, but only if each wrong option is a mistake real students make. Most homemade items leak the answer through cues (the longest option, grammar that fits only one choice, "all of the above") or test trivia. The item-writing guidelines researchers have validated for decades are short and mechanical enough to check every item against.

task

Write multiple-choice questions on this materialOnly if [LEVEL] is given: for .

material

Only if [LEARNING_OBJECTIVES] is given:

objectives

  1. Blueprint. Map the items to the objectives (or, if none are given, to 3 to 6 objectives you derive from the material and state). Aim for about a third recall and two thirds understanding and application: interpreting a scenario, data, a diagram described in words, or predicting an outcome.
  2. Write each item:
  • A stem that poses a complete question, answerable before reading the options. Put shared wording in the stem, not repeated in options.
  • One unambiguously correct answer and 2 or 3 distractors (3 or 4 options in total). Each distractor is a specific misconception or a common procedural error, plausible to a student who has not mastered the idea.
  • Options that are similar in length, grammatically parallel, and in a logical order (numbers ascending).
  • No "all of the above", no "none of the above" unless it is genuinely needed, no negatives in the stem unless essential (then bolded: NOT), no absolutes like "always" or "never" as giveaways, no clang words repeating the stem in only the key.
  1. Rationale. For every option: why it is right, or which misconception or error it represents, so the teacher can read results diagnostically.
  2. Check the set. Verify each key is correct and each distractor is genuinely wrong. Spread the correct answers evenly across letter positions. Make sure no item gives away the answer to another.
constraints
  • Items must be answerable from the material and the level; do not test facts outside it.
  • If the material is too short to support distinct items without trivial or near-duplicate questions, write fewer and say why.
  • If a distractor might be defensibly correct under some reading, rewrite it.
  • Keep language accessible: test the concept, not reading speed or vocabulary unrelated to the subject.
output format

Blueprint

A table: Objective | Items | Cognitive level.

Questions

Numbered items with options A to D (or A to C), no answers marked, so the section can be copied straight into a quiz.

Answer key and rationales

A table per item: Option | Correct? | Rationale or misconception.

Item checks

A short table: Item | Objective | Key position | Checks passed (stem complete, cues removed, distractors plausible), and the key distribution across positions.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Learning and education
category
Teaching
level
Intermediate
made for
Teacher / tutor
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 write-multiple-choice-questions --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-multiple-choice-questions -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 Teaching
PromptExam preparation

Generate a practice exam

Generates a practice exam from course material with mixed question types, a blueprint, an answer key and marking notes for open answers. Use to rehearse before a test.

generate-practice-exam
PromptTeaching

Create an analytic rubric

Builds an analytic rubric with distinct criteria, performance levels and observable descriptors aligned to learning objectives, plus scoring notes. Use when setting or marking an assignment.

create-rubric
PromptCourse design

Write measurable learning objectives

Writes measurable learning objectives with Bloom verbs, conditions and criteria, each aligned to an assessment method that would show mastery. Use when planning a lesson, module or course.

write-learning-objectives
PersonaTeaching

Instructional coach

Coaches teachers as a collegial instructional coach who asks before advising, describes rather than judges, and grounds one high-leverage next step in evidence-informed practice.

instructional-coach
PromptTeaching

Adapt a text to several reading levels

Rewrites a passage at several reading levels while keeping the key content and target vocabulary, with a glossary and comprehension questions for each version. For teachers with mixed-ability classes.

adapt-text-reading-level
PromptTeaching

Align a lesson or unit to standards

Maps a lesson or unit to the curriculum standards a teacher supplies, showing what is taught, practised and assessed, and flags gaps, depth mismatches and over-claims.

align-lesson-to-standards