audit-quiz-coverage — Claude Code command: quiz gap audit
The audit-quiz-coverage command for Claude Code and Codex compares recent releases and guide changes with quiz questions, then drafts questions for topics not yet covered.
CC-BY-SA-4.0 ★ 6,529 updated 2026-10-22
.claude/commands/audit-quiz-coverage.mdWhat audit-quiz-coverage does
The command reads four sources in sequence: the repo's CHANGELOG.md, machine-readable/reference.yaml for the guide's topic index, machine-readable/claude-code-releases.yaml for version history, and guide/core/claude-code-releases.md for full release context. For each quiz category, it compares existing questions against the most recent 10–15 Claude Code releases and newly added guide sections to surface topics with no question yet.
For every gap found, it drafts 2–5 new questions — four options each, a verifiable doc_reference pointing to a real guide file, and a one-line rationale explaining why the question is needed now. Everything goes into claudedocs/quiz-coverage-audit-{date}/proposals-new-questions.md. The command never writes to the live quiz directory and does not commit anything.
Pass a category id (01-quick-start, 04-agents, etc.) or all as the argument. Any YAML field value containing a colon must be quoted — skipping this broke the quiz build in previous audits.
What it helps with
- find Claude Code release topics that have no corresponding quiz question
- identify guide sections that exist but are never cited in question doc_references
- generate ready-to-paste question drafts with correct frontmatter for human review
- scope the audit to a single category instead of scanning all sixteen
- log topics where recent changes exist but a confident question could not be drafted
Example prompts for the agent
- Audit quiz coverage across all categories:
/audit-quiz-coverage all - Find gaps in the agents category only:
/audit-quiz-coverage 04-agents - Draft questions for recent hooks changes:
/audit-quiz-coverage 07-hooks
How to install audit-quiz-coverage
Manually: put the files in place
.claude/commands/audit-quiz-coverage.mdCall it with /audit-quiz-coverage. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/audit-quiz-coverage.mdCall it with /prompts:audit-quiz-coverage. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/audit-quiz-coverage.prompt.mdManually: put the files in place
.gemini/commands/audit-quiz-coverage.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about audit-quiz-coverage
How do I install audit-quiz-coverage in Claude Code?
Place the command file at .claude/commands/audit-quiz-coverage.md in your repository root. Claude Code will pick it up automatically.
What does audit-quiz-coverage do?
It reads the CHANGELOG, Claude Code release history, and the guide topic index, then compares them against existing quiz questions to find uncovered topics. It writes draft questions to a dated folder under claudedocs/ and leaves the live quiz files untouched.
Does the command modify the live quiz automatically?
No. It only writes proposals to claudedocs/ and never touches files under the live quiz directory. Adding questions requires a manual review step.