markermd-apply-rubric

Applies a stored grading rubric to student repositories and imports marks into a markermd project database.

3|Updated Aug 8, 2025
One-click install
npx skills add https://github.com/rundel/markermd --skill markermd-apply-rubric-rundel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markermd-apply-rubric
Source: https://github.com/rundel/markermd/tree/main/inst/skills/markermd-apply-rubric
Command: npx skills add https://github.com/rundel/markermd --skill markermd-apply-rubric-rundel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markermd.

What problem does it solve? Grading dozens of student Quarto or R Markdown submissions question by question is slow and repetitive. This Skill performs a headless first-pass grading across all repositories in a markermd project, pre-toggling rubric items with evidence notes so the human grader only reviews and corrects instead of starting from scratch. ## Core Features & Use Cases - Headless rubric application: Reads each repository's per-question sections, decides which rubric items apply (matching descriptions verbatim), and records reasoning as private notes. - Schema-validated marks YAML: Writes a marks file in format_version 1.0, validates it against the bundled JSON Schema, and imports it with marks_import() without clobbering existing grading. - Human-in-the-loop review: Shows the marks and per-question score arithmetic for explicit confirmation before importing, then surfaces selections pre-toggled in the mark() app. - Use Case: An instructor with 40 student hw01 repositories runs this Skill to pre-grade every question against the rubric, then opens markermd::mark() to review the suggested selections and private notes before finalizing grades. ## Quick Start Apply the stored rubric to all student repositories in my markermd project at ./hw01 and import the marks for review.

Frequently Asked Questions about markermd-apply-rubric

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

FAQPage Schema
How do I pre-grade student repositories with a rubric in markermd?

Run this Skill on an initialized markermd project that already has a stored template and rubric. It reads each repository's question sections, selects applicable rubric items, writes a marks YAML, and imports it with marks_import() after your confirmation.

What is required before applying a rubric to student repos?

The project must be initialized with markermd::init_project(), contain a stored grading template defining the questions, and have a rubric with items. If either is missing, use the markermd-scaffold-template or markermd-scaffold-rubric skills first.

Does marks_import overwrite existing grading in markermd?

No. By default marks_import() skips any repository-question pair that already has grading activity, including recorded grade rows or non-empty comments. Pass overwrite = TRUE only when you explicitly want those pairs re-marked.

Why does marks_import fail with a description mismatch error?

marks_import() matches rubric item descriptions exactly and aborts the whole import on any mismatch. Fix the marks YAML to copy descriptions verbatim from rubric_export() output; never edit the rubric to match the marks file.

Can students see the notes recorded during machine grading?

No. The Skill writes only private_comment notes, which are internal and never shown to students. The public comment field is left untouched because it is student-facing and reserved for the human grader's voice.

What happens to repositories that cannot be parsed during grading?

Repositories with validation errors, such as missing or unparseable documents, are excluded from the marks file and listed in the final report so the instructor can grade them manually in mark().