socratic-quiz

Guides users to understanding through adaptive one-at-a-time Socratic questioning.

2.0k|131|Updated Jul 30, 2025
One-click install
npx skills add https://github.com/pchalasani/claude-code-tools --skill socratic-quiz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: socratic-quiz
Source: https://github.com/pchalasani/claude-code-tools/tree/main/plugins/workflow/skills/socratic-quiz
Command: npx skills add https://github.com/pchalasani/claude-code-tools --skill socratic-quiz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Direct explanations often produce shallow understanding that fades quickly. This Skill replaces passive explanation with guided questioning, so users build durable comprehension by reasoning through concepts themselves.

Core Features & Use Cases

  • Adaptive Questioning: Starts with a foundational question, then adjusts difficulty up or down based on each answer, progressing from foundational to nuanced concepts.
  • Misconception Handling: Responds to incorrect answers with reframed questions, counterexamples, and small hints instead of revealing the answer directly.
  • Synthesis and Wrap-Up: Periodically asks questions that combine multiple concepts, and ends with a brief summary of demonstrated understanding and areas for further exploration.
  • Use Case: A developer wants to truly understand how Python generators work rather than just copying examples. They say "quiz me on generators" and the Skill walks them through discovery with one targeted question at a time.

Quick Start

Ask the assistant to quiz you on a topic you want to understand, for example: "Quiz me on how HTTP caching works using Socratic questioning."

Frequently Asked Questions about socratic-quiz

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

FAQPage Schema
How do I use Socratic questioning to learn a technical topic?

State the topic you want to understand and ask to be quizzed on it. The Skill starts with a foundational question, then adapts difficulty based on your answers, asking one question at a time until you demonstrate understanding.

What happens when I answer a quiz question incorrectly?

The Skill does not reveal the correct answer. It acknowledges the reasonable part of your thinking, then asks a narrower or reframed question, offers a counterexample, and gives a small hint only after two or three stuck attempts.

Can I use this for learning programming concepts?

Yes. For code or system topics, the Skill frames questions around specific behavior, output, or structure you would encounter, without showing you the answer directly. It works for any topic where guided reasoning beats passive reading.

Does the Socratic quiz give me a score or grade at the end?

No. When you stop the quiz, it gives a brief two-to-three sentence summary of what you demonstrated understanding of and which areas might benefit from further exploration, with no grade or score.

When is a direct explanation better than Socratic questioning?

Direct explanation is better when you need a quick factual answer, are under time pressure, or already understand the topic and just need a reference detail. You can explicitly ask to stop the quiz and be told the answer at any point.