push-quiz

Quizzes users on committed code changes before allowing git push approval.

1|Updated Mar 12, 2025
One-click install
npx skills add https://github.com/void2610/dotfiles --skill push-quiz-void2610
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: push-quiz
Source: https://github.com/void2610/dotfiles/tree/main/.claude/skills/push-quiz
Command: npx skills add https://github.com/void2610/dotfiles --skill push-quiz-void2610

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents developers from pushing code they do not fully understand by gating git push behind a comprehension quiz on the actual diff, turning every push into a learning checkpoint. ## Core Features & Use Cases - Diff-grounded quizzing: Reads the real git diff against the default branch and generates 4-choice questions about the technologies, design trade-offs, and pitfalls present in the committed code. - Approval gating: Requires all questions answered correctly plus explicit user permission before running ship.sh quiz approve, which binds approval to the HEAD SHA and auto-expires on new commits. - Iterative re-quizzing: Re-asks missed concepts in later rounds with code references (file:line) until full comprehension is demonstrated. - Use Case: During a ship workflow, after committing a refactor that uses git commit-tree, the skill quizzes you on how the plumbing command works and why that approach was chosen before unlocking the push. ## Quick Start Ask the assistant to quiz me on my committed changes before pushing, then answer the questions and explicitly approve the push.

Frequently Asked Questions about push-quiz

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

FAQPage Schema
How do I quiz myself on code changes before git push?▼

Trigger the push-quiz skill during the ship flow's quiz phase or by asking to be quizzed. It reads the actual git diff against the default branch, generates 3-8 questions about the techniques and design decisions in your commits, and only approves the push after all answers are correct.

How does push approval work with git commit SHA?▼

Approval is recorded by running ship.sh quiz approve, which binds the approval to the current HEAD SHA. If you add or amend commits afterward, the SHA mismatch automatically invalidates the approval and the quiz must be retaken.

What kinds of questions are asked in a pre-push code quiz?▼

Questions cover how the used technologies work, design trade-offs and rejected alternatives, generalizable patterns, common pitfalls, and trust boundaries. Trivial fact-recall questions answerable by skimming the diff or commit messages are explicitly excluded.

Can I skip the push quiz when in a hurry?▼

The skill never skips the quiz on its own, even for trivial changes. Only the user can bypass it by explicitly running ship.sh skip quiz with a stated reason, keeping the decision in the user's hands.

Does the push quiz work on any machine?▼

No, the gate is only enabled on the host PCmac24055, as determined by the quiz_enabled() check in ship.sh. On other machines the ship flow's quiz phase is skipped automatically.