hermes

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.

context

A class average says almost nothing a teacher can act on. What they need is which skills are weak for most of the class (re-teach to everyone), which are weak for a few students (small group), which items were probably badly written rather than badly learned, and what the wrong answers say about how students are thinking. With class-sized data the numbers are small, so the analysis must be honest about what a handful of responses can and cannot show.

task

Analyse these assessment results.

scores

Only if [ITEM_TO_STANDARD_MAP] is given:

item to standard map

Only if [CLASS_SIZE] is given: Class size: students.

  1. Check the data first. State how many students and items you read, the scoring (right/wrong, points, letters), and any problems: blank cells, inconsistent scales, rows that look duplicatedOnly if [CLASS_SIZE] is given: , and how many of the students are missing. If the table cannot be read reliably, stop and say exactly what format you need.
  2. Per item: compute the percentage correct (or mean score as a percentage of the maximum). If letter answers are given, count how many chose each option. If letters are given but no answer key, do not guess the key from the most popular answer: ask for it, and meanwhile report only the option counts.
  3. Per standard or skill: group items using the map. If no map is given, infer skill groups from the item content if it is visible and mark them "inferred"; otherwise analyse items only and say so. Report the class percentage per standard and the number of students at or above 80%, 50 to 79%, and below 50% on it.
  4. Suspect items: flag items that may be flawed rather than hard: an item that students who did well overall missed more often than weaker students, an item where one wrong option drew more answers than the key, or an item far out of line with others on the same standard. Recommend checking the item before re-teaching.
  5. Misconceptions: from popular wrong answers and patterns of errors, state the likely misconception behind each, and mark it as a hypothesis to confirm by talking to two or three students.
  6. Reteaching groups: decide which skills need whole-class re-teaching (roughly under 60 to 70% correct for the class), which need a small group, and which students are secure and need extension. List students by the identifiers given.
  7. Next steps: the three highest-impact actions for the next one or two lessons.
constraints
  • Do the arithmetic carefully and show the numbers that each conclusion rests on. Do not round away differences that matter, and do not report differences of one or two students as meaningful trends.
  • With fewer than about 5 items on a standard, or fewer than about 15 students, say that the evidence is thin.
  • Never invent scores, answers, standards or students. If something you need is missing, say what and continue with what you have.
  • Describe performance on skills, not the worth of students: no labels like "low kids" or "weak students". Groups are temporary and based on this assessment only.
  • Use only the identifiers in the data. If the data contains full names, refer to students by initials in your output and remind the teacher not to share identifiable data with tools their school has not approved.
  • Thresholds above are defaults; if the teacher's message gives their own mastery cut-off, use it.
output format

Data check

Students, items, scoring, and any problems found.

Headline findings

3 to 5 bullets a teacher can read in 30 seconds.

Results by standard

Table: Standard or skill | Items | Class % | ≥80% | 50–79% | <50% | Action (whole class / small group / secure).

Item analysis

Table: Item | % correct | Most common wrong answer (if letters given) | Flag.

Likely misconceptions

Bullets: evidence → hypothesis → how to confirm it.

Reteaching groups

For each group: skill, students, what to do.

Next steps

Three numbered actions.

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-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 analyze-class-assessment-results --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill analyze-class-assessment-results -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

Design formative checks for a lesson

Designs in-lesson formative checks (hinge questions, mini-whiteboard prompts, exit tickets) that reveal specific misconceptions, with a decision rule for what to do next.

design-formative-assessment
PromptTeaching

Differentiate a lesson

Adapts an existing lesson for mixed abilities, English learners and students with documented accommodations while keeping the same learning goal. Use when one lesson must reach a varied class.

differentiate-lesson
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

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
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