Use this as a QA pass before shipping a compiled course. Checks hint ladders, rubric signals, lesson length, submission paths, and completion criteria, then files a report. Does not auto-fix.
Audits a course for ship-readiness and emits a QA report. This skill is a
reviewer, not an editor: it never changes course content. It reads the authoring
tree (and the compiled runtime pack, if present) and files issues to
authoring/outputs/<course-id>/qa-report.md.
Run this after /compile-course-pack but before handing the pack off.
$1 (course-id) must be provided.authoring/outputs/<course-id>/course.yaml must exist.authoring/outputs/<course-id>/lessons/<lesson-id>/.For each lesson id referenced in course.yaml:
Hint ladder depth
lessons/<lesson-id>/hints.md.## Hint or - level:).Rubric pass/fail signals
lessons/<lesson-id>/rubric.md.Grep to confirm each rubric item has both a pass: and fail:
signal line. Any rubric item missing either is an issue.Lesson length ceiling
lessons/<lesson-id>/lesson.md.Submission path present
submission_path:. Must be non-empty.Completion criteria present
completion_criteria:. Must be a non-empty
list. A single empty bullet counts as missing.course.yaml and collect every lesson id from every module.{lesson_id, check, severity, detail}.
severity: blocker for missing submission path, missing completion
criteria, or fewer than 3 hint levels.severity: warning for rubric signals and length ceiling.checkout_question (blocker if missing).learning_outcome is referenced by at least one module summary
(warning if orphaned).Write to create authoring/outputs/<course-id>/qa-report.md with:
# QA report for <course-id> and today's date.## Summary section: total lessons, blocker count, warning count, and a
ship/hold verdict. Ship only if blocker count is zero.## Blockers section listing each blocker grouped by lesson.## Warnings section listing each warning grouped by lesson.## Checks performed section enumerating the five per-lesson checks and
the two course-level checks, so reviewers know what was NOT checked.runtime/courses/.When this skill finishes:
authoring/outputs/<course-id>/qa-report.md exists and contains a summary,
blockers, warnings, and a checks-performed section.verdict: ship (blockers == 0) or
verdict: hold (blockers > 0).authoring/outputs/<course-id>/ has been modified.