Skip to content
Back to search

grade-studio

Hosted grading code for the Grade Studio Gemini skill (Lewis & Clark Law, Boley Law Library)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/alecpalm/grade-studio with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/alecpalm/grade-studio'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alecpalm--grade-studio/badge.svg)](/listings/alecpalm--grade-studio)

HTML

<a href="/listings/alecpalm--grade-studio"><img src="/api/listings/alecpalm--grade-studio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 117 lines
  1. # Grade Studio
  2. Grade Studio drafts letter grades from anonymous exam totals for Lewis & Clark Law School faculty. It keeps the class average at or below the school's maximum grade average (3.30 or 3.50). It was built by the Boley Law Library and runs inside Google Gemini as a skill.
  3. The professor decides every grade. Grade Studio gives a starting draft, flags the places worth a second look, and lets the professor change anything.
  4. All of the grading logic is in one file, [`grade-studio.js`](grade-studio.js), so anyone can read exactly how a draft is made.
  5. ## How a professor uses it
  6. 1. In Gemini, attach the score spreadsheet (or say "Open Grade Studio" and paste the Exam ID and Total columns).
  7. 2. Gemini opens Grade Studio in a Canvas window with the class loaded.
  8. 3. The professor checks the student count and total at the top, sets the maximum (3.30 or 3.50), adjusts any grade, and exports a CSV.
  9. ## How the draft is made
  10. The engine is the first part of `grade-studio.js` (`GradeStudioEngine`). In plain terms:
  11. 1. **Group students who must share a grade.** Students are sorted from highest to lowest total.
  12. - With **Keep ties together** on (the default), students with the same total are grouped.
  13. - With **Keep close scores together** set to a number of points, a student within that many points of the student above joins their group.
  14. 2. **First draft.** Each group gets a target in grade points:
  15. `maximum + 0.55 × (group total − class mean) ÷ standard deviation`, kept between 0 and 4.33.
  16. The target is rounded to the nearest grade on the Lewis & Clark scale. A group never gets a better grade than the group above it.
  17. 3. **Bring the average under the maximum.** While the class average is over the maximum, the engine lowers one group by one step at a time.
  18. - It picks the group where the move hurts least: the smallest added distance from that group's target, per grade point removed.
  19. - A higher score never ends up with a lower grade.
  20. 4. **Use any room left.** While there is room under the maximum, the engine raises one group by one step.
  21. - It prefers the move that uses the most room. On a tie, it picks the group closest to its target.
  22. - The average never goes over the maximum.
  23. The maximum is a ceiling, not a target. Grade Studio never pushes the average up to it beyond what the scores support.
  24. ### Professor's requests
  25. A professor can ask Gemini for changes like "no A+'s" or "give 4102 a B+". Gemini reopens Grade Studio with a settings line in the page:
  26. ```js
  27. const SET={"maxAverage":3.3,"highestGrade":"A","lowestGrade":"C","keepTiesTogether":true,"closeScoreGap":0,"setGrades":{"4102":"B+"}};
  28. ```
  29. - **`highestGrade` / `lowestGrade`** limit the range the draft can use.
  30. - **`setGrades`** fixes specific students' grades. Their grade points come out of the class budget first, so the whole class still stays at or under the maximum.
  31. - Settings never change a score.
  32. - The app lists every request at the top. Anything it can't use (a misspelled grade, an exam ID not in the class) is listed, not guessed.
  33. - A requested grade that breaks score order is flagged as a score inversion.
  34. ### What gets flagged
  35. - **Tied score:** same total as another student.
  36. - **Split tie:** same total but different grades, for example after a hand edit with ties not kept together.
  37. - **Score inversion:** a higher total with a lower grade than the next student.
  38. - **Close boundary:** the next student down is in a different grade but within 2.5% of the score range (at least 0.5 points).
  39. ### What gets refused
  40. When pasted or loaded scores have a problem, Grade Studio lists the problems instead of drafting. It refuses:
  41. - missing exam IDs
  42. - missing totals, or totals that aren't numbers (such as "INC")
  43. - duplicate exam IDs
  44. - names or emails in the ID column
  45. - a Total column where every value is the same
  46. A total of 0 gets a warning.
  47. ## Privacy
  48. - Grade Studio has no server and stores nothing.
  49. - The scores stay in the professor's browser window and are never sent anywhere by this code.
  50. - No student data is in this repository. The test data is made up.
  51. ## Making sure the code isn't changed
  52. The Gemini skill loads this file from jsDelivr, pinned to one commit, with a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) hash. If the file is changed, or the hash doesn't match, the browser refuses to run it.
  53. When Gemini fills in a class, it also adds a fingerprint of the scores, computed in Python. Grade Studio checks the fingerprint before drafting, so a changed score, a changed ID or a dropped row is caught.
  54. You can check the hash yourself:
  55. ```bash
  56. curl -s https://cdn.jsdelivr.net/gh/alecpalm/grade-studio@COMMIT/grade-studio.js | openssl dgst -sha384 -binary | base64
  57. ```
  58. Replace `COMMIT` with the commit the skill uses. The result should match the `sha384-…` value in the skill's page.
  59. ## Running the tests
  60. The tests need Node 18 or later:
  61. ```bash
  62. node --test tests/*.test.js
  63. ```
  64. They check:
  65. - the grade range and requested grades
  66. - the built-in self-test
  67. - that the average never goes over the maximum (1,000 random classes)
  68. - that a higher total never gets a lower grade
  69. - that ties stay together
  70. - the close-score gap
  71. - the flags
  72. - reading pasted text
  73. - that the data fingerprint matches the skill's Python
  74. ## Files
  75. - `grade-studio.js` has the engine, the paste reader and the page.
  76. - `tests/engine.test.js` has the tests above.
  77. The styling and the Gemini skill instructions live with the skill, not here.
  78. ## Changes
  79. Each change is a new commit. A new commit needs a new commit hash and integrity hash in the skill, so the skill only ever runs code that someone has reviewed. Old commits stay in place, so older copies of the skill keep working.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.