quiz-me

Generates code-grounded multiple-choice quizzes that assess understanding of a codebase implementation.

Updated Dec 18, 2025
One-click install
npx skills add https://github.com/l0lxl0lw/dotfiles --skill quiz-me-l0lxl0lw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quiz-me
Source: https://github.com/l0lxl0lw/dotfiles/tree/main/ai/shared/skills/understand/quiz-me
Command: npx skills add https://github.com/l0lxl0lw/dotfiles --skill quiz-me-l0lxl0lw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading code or docs rarely proves you actually understand how a system works. This Skill tests your understanding of a concept as it is implemented in your own codebase, scores you against an 80% pass mark, and teaches only the concepts you missed. ## Core Features & Use Cases - Implementation-grounded questions: Reads the actual code first, building ten concept questions with five variations each and distractors drawn from rejected alternatives, superseded designs, and spec/code divergences. - Structured assessment: Asks ten multiple-choice questions in batches, scores at 80% to pass, and reports a card naming the misconception behind each wrong answer. - Targeted reteaching: Teaches each missed concept with file-and-line citations, then re-asks it from an unseen variation until you pass or exhaust all five angles. - Use Case: After reviewing a billing service's allocation logic, run the quiz on "signed allocations" to verify you can explain the invariants, locking, and failure modes before modifying that code. ## Quick Start Ask the AI to quiz me on how signed allocations work in this repository until I demonstrably understand it.

Frequently Asked Questions about quiz-me

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

FAQPage Schema
How do I test my understanding of a codebase concept?

Invoke the quiz with a topic, optionally with a path, such as asking to be quizzed on a specific module. The skill reads the actual implementation, writes ten concept questions with multiple-choice options drawn from the real code, and scores you at an 80% pass mark.

How are the quiz questions generated?

Questions are written only after reading the implementation, covering ten distinct concepts with five variations each: definition, mechanism, worked example, counterfactual, and code-grounded. Distractors encode specific misconceptions drawn from rejected alternatives and superseded designs.

What happens if I fail the quiz?

Each missed concept is taught one at a time with concrete file-and-line citations explaining why your chosen answer fails. The concept is then re-asked from a variation you have not seen, looping until your running score reaches 8 out of 10.

Can the quiz use general textbook questions instead of code?

No. The skill explicitly forbids falling back to textbook questions, since a question answerable from general knowledge measures nothing about understanding the specific system. Every option must cite something real such as a column, function, constraint, or error code.

What happens if I miss a concept on every variation?

If a concept is missed on all five variations, the skill stops testing it, teaches it once more in full, and points you at the specific files to read. It never awards an unearned pass or quietly drops a concept to reach the threshold.