course-quiz-builderlisted
Install: claude install-skill the3ma/course-quiz-builder
# Course Quiz Builder
Turn course content into **one self-contained HTML page** that shuffles its questions,
lets the learner preview and edit answers before submitting, then reports **Test passed /
Test failed** with a per-question right/wrong answer key.
Two inputs: **course name** and a **markdown file** of course content. Output: `quiz.html`
— no build step, no dependencies, no network. Double-click it and it works.
## Pipeline
You author the questions; the script renders and validates them. Never hand-write the HTML.
```
course .md → [you: extract + write questions.json] → build-quiz.mjs → quiz.html
↓ fails hard on bad keys
selftest.mjs --html quiz.html
↓ must print PASS
publish-pages.mjs → GitHub Pages
```
| Step | What you do |
|---|---|
| 1. Read | Read the markdown. Map its `##` lessons → sections, and each "By the end of this lesson" bullet + Key takeaway → a candidate question. |
| 2. Size | Question count = content size (see table below). Confirm count + pass mark with the user if either is unstated and the content is large. |
| 3. Author | Write `questions.json` next to the source `.md`. Follow references/question-design.md — it is the difference between a quiz and a trivia dump. |
| 4. Build | `node <skill>/scripts/b