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.
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.
Write a comprehension set on ph:topic at ph:reading_level with questions.
- 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.
- 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.
- 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…?").
- Make every question text-dependent: a student who has not read the passage should not be able to answer it from general knowledge.
- 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.
- Tag each question with the skill it tests.
- 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.
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
use in
npx @hermes-hq/hodios install write-reading-comprehension-set --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-reading-comprehension-set -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 TeachingAdapt 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-levelPlan 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-instructionWrite 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-questionsAlign 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-standardsAnalyse 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-resultsAssessment 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