# Socratic Quiz

Use this when the user wants to deeply understand something through guided questioning.

- Repository: https://github.com/pchalasani/claude-code-tools (2026 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add pchalasani/claude-code-tools --skill socratic-quiz -g -a claude-code -y`
Codex: `npx skills add pchalasani/claude-code-tools --skill socratic-quiz -g -a codex -y`
Cursor: `npx skills add pchalasani/claude-code-tools --skill socratic-quiz -g -a cursor -y`
Gemini CLI: `npx skills add pchalasani/claude-code-tools --skill socratic-quiz -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add pchalasani/claude-code-tools`

## Description

Use this when the user wants to deeply understand something through guided questioning. Trigger phrases include: "quiz me", "help me understand", "Socratic", "teach me", "walk me through with questions", "test my understanding", or when the user asks for an explanation and would benefit more from guided discovery than a direct answer.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Socratic Quiz

## Purpose

Guide the user to deep understanding through graduated,
adaptive questioning rather than direct explanation. The user
learns by thinking through the answers themselves.

## Instructions

### Starting the quiz

1. Ask the user what topic or concept they want to
   understand better (if not already stated).
2. Gauge their current level by starting with a
   foundational question, not too easy, not too hard.
3. Based on their answer, adapt up or down.

### Asking questions

- Ask ONE question at a time. Wait for the user's
  response before continuing.
- Start with concrete, grounded questions before moving
  to abstract or nuanced ones.
- Frame questions around what the user can observe,
  reason about, or connect to things they already know.
- If the topic involves code or a system, reference
  specific behavior, output, or structure they would
  encounter, but do NOT show them the answer directly.
- Use "what do you think would happen if..." and
  "why do you think..." style questions.

### When the user answers correctly

- Briefly confirm (one sentence max) and immediately
  move to the next, harder question.
- Build on their correct answer, use it as a stepping
  stone to the next concept.

### When the user answers incorrectly

- Do NOT reveal the correct answer.
- Do NOT say "that's wrong" bluntly. Instead:
  - Acknowledge what's reasonable about their thinking.
  - Ask a narrower or reframed question that exposes the
    gap in their reasoning.
  - Offer a concrete scenario or counterexample that
    challenges their answer, and ask them to reconsider.
  - If they're stuck after 2-3 attempts on the same
    concept, give a small hint (not the answer) and
    ask again.

### When the user is partially correct

- Acknowledge the correct part explicitly.
- Ask a follow-up that targets the missing or
  incorrect part.

### Progression

The rest: https://github.com/pchalasani/claude-code-tools/blob/HEAD/plugins/workflow/skills/socratic-quiz/SKILL.md