markermd-scaffold-rubric

Generates and imports a per-question grading rubric YAML for markermd assignment projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markermd.

What problem does it solve? Authoring a grading rubric item by item in the markermd app is slow, especially for assignments with many questions. This Skill scaffolds a complete rubric (per-question items, point values, and scoring setup) from the solution key and optionally sampled student submissions, then validates and imports it into the project's grading database. ## Core Features & Use Cases - Key-derived rubric drafting: Reads the solution repository question by question and drafts concrete rubric items based on the actual code and answers, with an option to sample student repos to anticipate common mistakes. - Point distribution planning: Asks for the assignment's total points and proposes equal, content-weighted, or assignment-stated per-question distributions. - Validated import: Writes the rubric as YAML, validates it against the bundled JSON Schema, and imports it with markermd::rubric_import() in append or replace mode, either all at once or one question at a time. - Use Case: An instructor has initialized a markermd project for a homework assignment and stored a grading template. Use this Skill to generate a first-pass rubric for every question before grading begins in mark(). ## Quick Start Scaffold a grading rubric for my markermd project in the hw01 directory based on the solution key.

Frequently Asked Questions about markermd-scaffold-rubric

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

FAQPage Schema
How do I generate a grading rubric for a markermd project?

Run this Skill on an initialized markermd project that already has a stored grading template. It reads the template's questions, drafts rubric items from the solution key, writes a rubric YAML file, validates it, and imports it with markermd::rubric_import().

What is required before scaffolding a markermd rubric?

The project must be initialized with markermd::init_project() and must already have a grading template stored in its database, since rubric question names must match the template exactly. Use the markermd-scaffold-template skill or the template() app first if no template exists.

Can the rubric be based on student submissions as well as the solution key?

Yes. The key plus student repos basis samples roughly 5-8 student submissions, prioritizing repos with different validation failures, to draft deduction items for mistakes actually observed. The key-only basis derives items solely from the solution.

What is the difference between positive and negative grading modes in markermd?

Negative (deduction) mode starts each question at total_score and items carry negative points for defects. Positive (additive) mode starts at zero and items carry positive points for achieved elements, with partial-credit items summing to approximately the question total.

Why does rubric_import fail with a question name error?

The rubric's question names must match the stored template's question names exactly, character for character. Export the template with markermd::template_export() and copy the names verbatim; never rename template questions to match the rubric file.

What happens to existing rubric items when importing a new rubric?

Append mode (the default) adds the file's items after each question's existing items. Replace mode deletes the affected questions' existing items along with all recorded selections of those items for every repository, which cannot be undone.