Review notes for gaps
Compares a student's notes against the syllabus or textbook to find missing topics, errors and shallow areas, and says exactly what to add, in priority order. Use before revision starts.
Students revise from their own notes, so anything missing or wrong in them is missing or wrong in the exam. Notes usually fail in three ways: whole topics were never written down (a missed lecture), topics are present but shallow (a definition with no mechanism, example or application), and a few points are simply incorrect. A syllabus says what must be covered and to what depth; a textbook says what is correct. The job is a coverage audit, not a rewrite.
Audit these notes against the reference.
- Decide what the reference is: a syllabus (tells you what to cover and how deeply, through verbs like "describe", "explain", "evaluate") or source material (tells you what is correct). Say which, because it limits what you can check.
- Break the reference into a checklist of items: learning outcomes or headings, with the depth each implies.
- Map the notes to each item and rate it:
- Covered: present at the depth required.
- Shallow: present but missing the depth required (for example, the outcome says "explain" and the notes only define).
- Missing: not in the notes.
- Check the accuracy of what the notes say. With source material, check against it and cite where it says otherwise. With only a syllabus, check against well-established knowledge, and mark each correction "verify in your textbook".
- Note material in the notes that is not in the reference; say it may be off-syllabus, but do not tell the student to delete it.
- Prioritise what to add: errors first, then missing items that carry the most weight or appear most in the reference, then shallow areas. For each, say specifically what to add (the missing step, mechanism, example or distinction) in one or two lines and where to find it in the source if given.
- Do not rewrite the notes or produce full replacement notes. Give targeted additions the student writes themselves.
- Quote the student's note when reporting an error or a shallow point.
- Do not mark something wrong unless you are confident; if unsure, flag it as "check" with the reason.
- If the notes and the reference are about different topics, or either is too short to audit, say so and stop.
Coverage
A table: Reference item | Status (covered, shallow, missing) | Note. Then one line: the counts of each status.
Errors
Numbered: the quoted note, what is wrong, the correct idea, the source location or "verify in your textbook".
Shallow areas
Each: the item, what depth is needed, what to add.
Missing
Each: the item and what to add.
Add these next
The top 5 to 8 additions in priority order, each one line, ending with a two-question self-test on the most important missing item.
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
- Studying
- level
- Beginner
- made for
- Student
- 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 review-notes-for-gaps --target claude-codenpx skills add hermes-hq/hodios-dist --skill review-notes-for-gaps -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 StudyingConvert lecture notes to Cornell format
Converts raw lecture notes into Cornell format with cue questions, a summary and a list of gaps to check, then explains how to review them. For students who take notes but never revisit them.
convert-lecture-notes-to-cornellMake a study guide from notes
Turns lecture notes or a chapter into a study guide of key concepts, definitions, relationships, common confusions and likely exam questions. Use when revising a unit.
make-study-guideMake flashcards from notes
Turns notes or a chapter into atomic flashcards, one fact per card with cloze deletions where they help, ready to import into Anki. Use when studying from your own material.
make-flashcardsStudy coach
Coaches learners on how to study, teaching retrieval practice and spacing, helping them plan and reflect, and holding them to small commitments. Use for ongoing study support.
study-coachTurn marked feedback into targets
Translates tutor comments on marked essays or coursework into a few concrete targets, shows what each looks like done well, and builds a checklist for the next assignment.
act-on-marked-feedbackAdapt study for a learning difference
Adapts study techniques for a learner with ADHD, dyslexia or dyspraxia, with environment changes, tools, chunking, a two-week experiment and how to request support.
adapt-study-for-learning-difference