# Exam Paper Desk

> Blueprint, write and review an exam paper. Paste an exam brief - and a draft paper, if you have one - and get the
> blueprint and a check free in the browser; a metered run writes the paper and its mark scheme to the blueprint, laid
> out for print, or reviews the draft. Built on the SkillSafe skill @suzheng/k2f-exam-paper (suzheng/k2f, Apache-2.0).

https://exam-paper-desk.skillsafe.ai/

## The input format
Header lines (Course:, Assessment:, Time:, Total:, Rules:, Past papers:), the coverage map under Topics: (one bullet per
topic, with a weight in %, marks or teaching hours), optional Outcomes:, and optionally a draft under Paper: - questions
numbered "1." with a [Topic] tag and marks in brackets, sub-parts "a)" with their marks, multiple-choice options "A.".

## What is free
- The blueprint: each topic's target marks - the weights scaled to the total and rounded by largest remainder so they add up - and the pace in marks a minute.
- Checks on the brief: no total, no time, no rules, no topics, weights that do not add up, a pace above 1.5 or below 0.4 marks a minute.
- Checks on a draft: paper marks that do not add up to the total, sub-parts that do not add up to their question, questions without marks, untagged questions, questions on topics outside the map, topics with no question, topics whose marks drift from the target, compound calls ("describe and explain"), open calls without length, form or evidence, "all/none of the above" or uneven option counts, duplicate stems, "show your working" repeated.
- Blueprint CSV, findings CSV, the check as Markdown.

## The metered lanes
Two tasks on gpt-terra, metered per run, routed by `task`. Input string fields: `task` (write or review), `brief`, `focus` (optional) and `facts` (the page's reading).
- `write` replies with `summary`, `instructions`, `sections` (items with id, topic, outcome, style, marks, stem, parts with calls and answer lines, or options and a key), `scoring` (answer and marking points per item), `coverage`, `findings`, `prescan`, `out_of_scope` and `notes`. The page requires the marks to add up at every level and to the total, every item on a map topic, each topic on its target (or the departure stated), a scoring entry per item whose points add up, the claimed coverage to equal the paper's, sound multiple choice and no compound or bare open calls; it prints the paper and the mark scheme separately.
- `review` replies with `verdict` (ready, revise, rework), `summary`, `findings`, `prescan`, `items` (keep, revise with a rewrite, or cut, per draft question), `coverage`, `questions` and `caveats`. A review can be handed to the write lane as its focus.

## Links
- API tutorial: https://exam-paper-desk.skillsafe.ai/api.html
- Source skill: https://skillsafe.ai/skill/@suzheng/k2f-exam-paper