codebase-quizzer

Quizzes users on codebase structure, execution flow, and design decisions with persistent progress tracking.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill codebase-quizzer-pulak999
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-quizzer
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/claude-skills/codebase-quizzer
Command: npx skills add https://github.com/pulak999/ai-tooling --skill codebase-quizzer-pulak999

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After agentic coding tools generate or modify a codebase, developers often struggle to understand what was actually built. This Skill turns codebase comprehension into an interactive quiz, progressively deepening understanding of execution flow, design decisions, and data structures across sessions. ## Core Features & Use Cases - Progressive Quizzing: Asks 6 targeted questions per session covering execution flow, design decisions, data structures, entry points, module relationships, and error handling. - Difficulty Scaling: Automatically raises difficulty from level 1 to 5 as session count grows, moving from surface-level questions to deep architecture and edge cases. - Persistent Progress: Stores session count, topics covered, and scores in a progress.json file inside the target codebase so questions never repeat. - Use Case: After an AI agent scaffolds a new web service, run /codebase-quizzer on the project directory to verify you understand how requests flow through the code before modifying it. ## Quick Start Invoke /codebase-quizzer with the path to your codebase, for example by asking to be quizzed on the project at ./my-app.

Frequently Asked Questions about codebase-quizzer

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

FAQPage Schema
How do I quiz myself on a codebase I didn't write?

Invoke /codebase-quizzer with the path to the codebase root. The skill explores the directory structure and key files, then asks 6 questions per session about execution flow, design decisions, and data structures, showing real code snippets in its explanations.

How does codebase quiz difficulty progression work?

Difficulty is stored in progress.json and scales from 1 to 5 based on session count. Sessions 1-2 ask surface-level questions, while sessions 10 and beyond cover deep architecture, extension scenarios, and failure modes.

Where is codebase quiz progress stored?

Progress is stored in a .codebase-quizzer/progress.json file inside the target codebase directory. It tracks session count, difficulty, topics covered, questions asked, and your correct answer ratio.

Can I get hints during a codebase quiz?

Yes, type hint during any question and the skill points you to the specific file and line range where the answer lives. Only one hint is allowed per question.

Does the codebase quiz repeat questions across sessions?

No, the skill checks the questions_asked list in progress.json before choosing questions and keeps the last 30 question summaries. Each session also covers different topics tracked in topics_covered.