hermes

Build a weighted gradebook spreadsheet

Builds a teacher's gradebook with weighted categories, dropped lowest scores, late penalties and letter grades, with the exact formulas. Use when setting up a course gradebook in a spreadsheet.

context

You are an experienced teacher and spreadsheet builder. A gradebook is a policy written in formulas: students and parents will challenge any grade, so every number must be reproducible by hand from the syllabus. The common errors are well known: treating "not yet graded" as zero, dropping the lowest raw score instead of the lowest percentage, weights that silently stop adding to 100% mid-term, and late penalties that push scores below zero.

task

Build a gradebook in for this course.

categories and weights

grading scale

  1. List the policy choices the formulas depend on, with the default you will use if the teacher has not said:
  • Within a category, total points (sum earned over sum possible) or equal-weight average of percentages. Default: total points, unless items have very different point values and the syllabus says each counts equally.
  • Blank means not yet graded or excused, and is excluded; 0 means missing work. Use a code such as EX for excused.
  • Running grade: renormalise weights over categories that have graded work so far, so an early-term grade is not deflated by empty categories.
  • Dropping: drop the item with the lowest percentage, removing both its earned and possible points; never drop more items than were graded.
  • Late penalty: applied to the earned score as a percentage of possible points per day late after any grace period, capped, and never below zero.
  • Boundaries: whether to round the final percentage before the letter lookup. If the weights do not add to 100%, stop and ask.
  1. Layout: a Settings sheet (categories, weights, drops, late rule, grade scale table sorted ascending), an Assignments sheet (ID, name, category, points possible, due date), and a Scores sheet with one row per student and one column per assignment. Late submissions: a matching Submitted-date block, or a days-late block, whichever is simpler for the teacher; say which.
  2. Formulas, each for one student row, referencing Settings by named ranges rather than typed numbers:
  • Adjusted score per item after the late penalty.
  • Category earned and possible with SUMIFS-style logic over the assignment header row, skipping blanks and EX.
  • Drop lowest: in Microsoft 365 or Google Sheets, use LET with FILTER and a sort by percentage to keep all but the lowest k items: SORTBY in Excel, SORT with the percentage array as its sort column in Google Sheets (which has no SORTBY). Give an older-Excel fallback for dropping one item (subtract the item whose percentage equals the minimum, using a helper row of percentages).
  • Category percentage, weighted final percentage with renormalised weights, and the letter grade with XLOOKUP in next-smaller match mode or VLOOKUP with approximate match on the ascending scale.
  1. Work one fictional student through by hand, showing each step, so the teacher can verify the sheet against it.
constraints
  • Use only functions available in , with comma separators, and note once that some locales use semicolons.
  • No numbers typed into formulas that live in Settings (weights, penalties, cut-offs, number of drops).
  • Use invented student names only in the worked example; remind the teacher not to paste real student records into an AI chat.
  • Keep formulas readable: use LET where it helps and helper rows rather than one unreadable formula.
  • If the policy text is ambiguous (for example "drop the lowest quiz" when quizzes have different point values), state the interpretation you used and how to switch.
output format

Policy choices to confirm

Table: Choice | What the formula does | Change it by.

Workbook layout

Each sheet with its columns and the named ranges.

Formulas

Table: Purpose | Cell | Formula | Notes. Formulas in code formatting, ready to paste.

Worked check

One fictional student, category by category, ending in the final percentage and letter.

Maintenance

Three to five bullets: adding an assignment, excusing a student, changing a weight mid-term, protecting formula cells.

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
Data analysis
category
Spreadsheets
level
Intermediate
made for
Teacher / tutor
risk
read-only
version
v1.0.1 · 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 build-gradebook-spreadsheet --target claude-code

This entry is in the full catalog, not the curated set the skills installer and plugins carry, so install it with the Hodios CLI.

pairs well with

All of Spreadsheets
PromptSpreadsheets

Write a spreadsheet formula

Builds an Excel or Google Sheets formula from a plain-language goal and the sheet layout, explains how it works and flags edge cases. Use when you know the result you want but not the formula.

write-spreadsheet-formula
PromptSpreadsheets

Set up data validation for a shared sheet

Sets up data validation, dependent dropdowns, input messages and protected ranges so a shared sheet stays clean, with step-by-step instructions. Use before handing a sheet to other people.

set-up-data-validation
PromptSpreadsheets

Extract tables from a PDF

Extracts tables from PDF or scanned text into clean CSV, Markdown or JSON, keeps values exactly as printed, flags likely OCR errors and validates totals against the source. Use before analysis.

extract-tables-from-pdf
PromptSpreadsheets

Run a what-if analysis

Builds a scenario and sensitivity analysis for a decision (best, base and worst cases, a tornado chart and breakevens) as a spreadsheet layout with exact formulas. Use before committing to a plan.

run-what-if-analysis
PromptSpreadsheets

Audit a spreadsheet model

Audits a spreadsheet model for hard-coded values, broken ranges, inconsistent formulas, circularity, unit mistakes and missing checks, ranked by impact. Use before relying on someone else's sheet.

audit-spreadsheet-model
PromptSpreadsheets

Build a loan amortisation schedule

Builds a loan amortisation schedule in a spreadsheet with payment formulas, extra-payment scenarios and total interest, explaining each column. Use to see how a loan or mortgage pays down.

build-amortization-schedule