markermd-scaffold-template

Generates a markermd grading template YAML from a solution repository and validates it across student submissions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Authoring a grading template for a markermd project by hand requires knowing exact Pandoc heading anchors, rule syntax, and YAML schema details. This Skill automates that bootstrap: it reads the project config, derives questions and starter validation rules from the key (solution) repository, imports the template into the grading database, and checks it against every student repository. ## Core Features & Use Cases - Template scaffolding from the key: Parses the solution repository's assignment document via assignment_outline() to get ground-truth section anchors, then builds questions with starter rules (code chunk plus markdown write-up by default). - Database import and schema validation: Writes markermd-template.yaml, optionally validates it against the bundled JSON schema, and imports it into the project's SQLite grading database with template_import(). - Cross-repo validation report: Runs validate_project() over all student repositories and summarizes which rules pass, fail, or error per question. - Use Case: An instructor collects 40 student Quarto assignments via ghclass and wants a starting rubric structure; the Skill generates the template from the solution key and reports how the starter rules hold up across all 40 submissions. ## Quick Start Scaffold a markermd grading template for my initialized project at ./hw01 using its key repository, then validate it against all student repos.

Frequently Asked Questions about markermd-scaffold-template

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

FAQPage Schema
How do I create a markermd grading template automatically?

Run the scaffold workflow on an initialized markermd project: it reads .markermd/config.yml, builds questions from the key repository's assignment outline, writes markermd-template.yaml, and imports it into the project database with template_import().

How do I validate a grading template against student repositories?

Use markermd::validate_project() with the project root. It loads the stored template, discovers repositories under the configured repos path, and returns one row per repo/question with pass, fail, or error status plus details.

What project setup does markermd template scaffolding require?

The directory must be initialized with markermd::init_project() on a ghclass::org_grade_assignment()-style layout, producing .markermd/config.yml with paths to the key repository and student repos. The markermd R package must be installed.

Why does my template fail validation on every student repo?

A rule failing for almost every repo is usually too strict or its anchor does not exist in student documents. Anchors must be exact Pandoc-assigned ids from assignment_outline(); hand-derived anchors only surface as errors during validate_project().

Can I edit the scaffolded template afterwards?

Yes. The scaffold is intentionally minimal; open it with markermd::template("<root>") to refine rules, add assignment-specific content checks, and save edits back to the project grading database.