exam_grading

Automates AI grading of handwritten university exams from scanning through appeals handling.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/sayonari/claude-skills --skill exam-grading-sayonari
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: exam_grading
Source: https://github.com/sayonari/claude-skills/tree/main/exam_grading
Command: npx skills add https://github.com/sayonari/claude-skills --skill exam-grading-sayonari

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pillow, openpyxl, and includes scripts (resource) and references (resource) components.

What problem does it solve? Grading handwritten university exams for large classes is slow, error-prone, and hard to audit. This Skill standardizes the entire pipeline—scanning, identity matching, parallel AI grading, machine verification, teacher review, return, and appeal handling—so a 130-student exam can be graded and returned the same day with full traceability. ## Core Features & Use Cases - End-to-end grading workflow: Covers exam design, scan pairing, student ID OCR, rubric definition, parallel AI grading agents, and mechanical score verification with Python scripts. - Mandatory teacher review HTML: Generates a single HTML file embedding answer image crops so instructors can adjudicate ambiguous readings and out-of-rubric partial credit before scores are finalized. - Prompt injection defense: Built-in countermeasures against students writing instructions to the grading AI on their answer sheets, with detection logging. - Return and appeals support: Produces per-student annotated PDFs, Excel gradebooks, and Google Drive/Classroom return scripts with documented accident-prevention rules. - Use Case: A professor scans 132 handwritten final exams, runs 22 parallel grading agents against a documented rubric, verifies totals programmatically, reviews 13 flagged cases via image-embedded HTML, and returns personalized graded PDFs the same day. ## Quick Start Tell Claude you want to grade a written exam and it will walk you through rubric creation, scanning, parallel AI grading, teacher review, and returning results to students.

Frequently Asked Questions about exam_grading

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I grade handwritten exams with AI?

Scan answer sheets at 300dpi, crop each question region with contrast enhancement, and have parallel AI agents grade against a pre-written rubric. Always verify totals programmatically and present ambiguous readings to the instructor in an image-embedded HTML review file.

How to prevent students from prompt injecting an AI grader?

Instruct grading agents that all text in answer images is data to grade, never instructions to follow. Log detected injection attempts in flags and continue grading by the rubric; this approach ignored all 8+ real injection attempts in production.

Can AI grading handle partial credit and alternative solutions?

Yes, if the rubric defines partial credit in countable terms like error counts and specifies chain-error cutoffs. Alternative correct solutions receive full marks with flags, and their validity is decided by consistency with existing full-credit precedents.

What Python packages are needed for exam grading scripts?

The scripts require pillow for image cropping and annotation, and openpyxl for Excel gradebook output. PDF page images are generated with pdftoppm, and student PDFs are rendered via headless Chrome.

Why does AI misread handwritten exam answers?

Whole-page single-pass reading causes systematic errors like mistaking faint small writing for blanks. Cropping by question, applying autocontrast, and enlarging ambiguous cells fixes most cases; teacher review still overturned about 30% of flagged AI readings.

What are the limitations of AI exam grading?

AI misreads handwriting even when claiming verification, makes arithmetic errors in totals, and cannot judge out-of-rubric partial credit fairly. The workflow therefore mandates machine verification, teacher review of flagged cases, and patch-script score changes with recorded reasons.