hermes

Write a reading comprehension set

Writes an original passage at a target reading level with text-dependent literal, inferential and vocabulary questions, an answer key and the skill each question tests.

context

Comprehension questions often test something other than comprehension: general knowledge (answerable without the passage), memory of trivial details, or reading the question rather than the text. Good sets are text-dependent: every answer needs the passage. They move from what the text says (literal) to what it means (inference, main idea, cause and effect) to how it says it (word meaning in context, structure, author's purpose), and the answer key cites the evidence so a teacher can see why a student went wrong. The passage itself has to sit at the target level in sentence length, vocabulary and the background knowledge it assumes.

task

Write a comprehension set on ph:topic at ph:reading_level with questions.

  1. Write an original passage. Choose a length suited to the level (roughly 150 to 250 words for early primary, 300 to 500 for upper primary and lower secondary, 500 to 800 for older readers) and match the level in sentence length, vocabulary and assumed background knowledge. Include 3 to 5 words worth teaching, with enough context clues to work them out. Give it a title, and number the paragraphs so questions can refer to them.
  2. Write questions with this approximate mix: about a third literal (retrieve or locate), about half inferential (infer, main idea, sequence or cause and effect, character or author's purpose), and the rest vocabulary in context or text structure. Order them roughly as the passage unfolds, with a main-idea or synthesis question last.
  3. Mix formats: mostly short constructed response, a few multiple choice with plausible distractors, and at least one question that asks students to cite evidence ("Which sentence shows…?").
  4. Make every question text-dependent: a student who has not read the passage should not be able to answer it from general knowledge.
  5. Write the answer key: the answer, the paragraph that supports it, and for constructed responses what a full-credit answer must include and a common partial answer.
  6. Tag each question with the skill it tests.
constraints
  • The passage is original. Do not reproduce or closely paraphrase a published text.
  • For informational passages, use only well-established facts and keep numbers and claims general enough to be safe; list any specific fact a teacher should double-check in the teacher notes.
  • Content must be age-appropriate, inclusive and free of stereotypes; vary names and settings.
  • Questions use simpler language than the passage, so the question is never harder to read than the text.
  • If is a scale you cannot map with confidence, say what you assumed (for example "treated as roughly Grade 4") in the teacher notes.
  • Do not claim a precise readability score; describe the level qualitatively.
output format

Passage

Title, then numbered paragraphs.

Questions

Numbered questions, with options for multiple choice and lines like "_____" for written answers, ready to print.

Answer key

Table: # | Answer | Evidence (paragraph) | Skill | Full-credit notes.

Teacher notes

Level assumptions, words worth pre-teaching, facts to verify, and one extension question.

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
Teaching
level
Beginner
made for
Teacher / tutor
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 write-reading-comprehension-set --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-reading-comprehension-set -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
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

Plan vocabulary instruction for a unit

Plans explicit vocabulary instruction for a unit, selecting tier 2 and tier 3 words with student-friendly definitions, examples, practice routines across days and a quick check.

plan-vocabulary-instruction
PromptTeaching

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.

write-multiple-choice-questions
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
PromptTeaching

Analyse a class's assessment results

Analyses a class's scores by item and standard to find the weakest skills, likely misconceptions, suspect items and reteaching groups. Use after marking a test or quiz.

analyze-class-assessment-results
WorkflowTeaching

Assessment design track

Takes an assessment from blueprint and objectives to items, mark scheme or rubric, accessibility review and a pilot check, pausing for teacher approval between steps.

assessment-design-track