Home
cd ../playbooks
EducationBeginner

Socratic Tutor: Learn Any Topic to Mastery

A tutoring mode that diagnoses what you already know, then teaches by asking one question at a time, tracks a 0-5 skill map, and only finishes after a final assessment

2 minutes
By Jane StreetSource
#tutoring#socratic-method#learning#quizzing#mastery#spaced-review#education

Asking an AI to explain something feels like learning until you try to use it a week later. This playbook flips the roles: Claude asks, you reason, and a strict skill map shows what you've earned instead of what you've read.

Who it's for: self-taught developers, students preparing for exams, career changers picking up a new field, engineers learning a new language or system, anyone who has read the tutorial and still can't do the thing

Example

"Tutor me on SQL window functions" → Claude breaks the topic into subskills, asks 3-5 diagnostic questions one at a time, shows a skill map with your starting level for each, then drills you with predict-the-output and find-the-flaw questions until every subskill reaches 4/5 and you pass a final mixed assessment

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add socratic-tutor
# Socratic Tutor

Use this when the user explicitly asks to be taught, quizzed, or drilled to mastery on a topic. Trigger phrases: "teach me", "tutor me", "quiz me", "drill me", "help me master". Do not use it for one-off "explain X" or "what is X" questions.

Source: https://github.com/janestreet/agent_skills/tree/master/socratic-tutor

Act as a personal tutor that takes the user from their current level to genuine mastery of a topic using the maieutic (Socratic) method: teach primarily by asking questions that force the user to reason, predict, and explain, not by lecturing.

## Guard: confirm intent before starting

This is for an ongoing teaching session, not for answering questions. If the user asked a one-off question ("explain X", "what is X", "how do I use X"), answer it normally and do not start the tutoring loop. If intent is ambiguous, ask one short question ("Want a quick answer, or should I actually teach you this properly?") before launching the diagnostic. A false start costs the user an unwanted quiz; a confirmation costs one word.

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

Turns Claude into a personal tutor that uses the Socratic (maieutic) method. Instead of lecturing, it asks questions that make you predict, explain, and defend your reasoning. Each topic is split into 4-10 subskills, and each subskill is scored on a strict 0-5 scale that you earn through demonstrated performance, not by agreeing with an explanation.

It only starts when you ask to be taught: "teach me", "tutor me", "quiz me", "drill me", or "help me master". A one-off "what is X?" gets a normal answer. If it's unclear which you want, Claude asks one short question first.


Quick Start

Step 1: Create a Project Folder

mkdir -p ~/Documents/Tutoring

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ~/Documents/Tutoring/

Step 3: Start Working

cd ~/Documents/Tutoring
claude

Then say something like "Tutor me on Rust ownership" or "Quiz me until I've mastered TCP congestion control." Claude will ask a few diagnostic questions before it teaches anything.


How a Session Runs

  1. Diagnostic. Claude splits the topic into subskills and asks 3-5 questions, one at a time, from easy to hard. It teaches nothing until this is done.
  2. Skill map. You see a progress bar per subskill (levels 0-5) and a proposed starting point. You can override it.
  3. Teaching loop. For each subskill Claude asks one question and stops. If you're wrong, it asks a narrower question that exposes the contradiction rather than giving the answer. It explains directly only after 2-3 failed attempts, then re-tests the same idea from a different angle.
  4. Devil's advocate. When you're right, Claude sometimes pushes back ("are you sure? what about X?") to check you can defend the answer.
  5. Spaced review. Earlier subskills are re-tested without warning. Fail one and its level drops.
  6. Final assessment. The course ends only when every subskill hits the target (4/5 by default, 5/5 if you ask for full mastery). A mixed assessment with at least one question per subskill and one integrative problem decides it.

The Skill Map

0 unaware . 1 heard of it . 2 can follow along . 3 can do with help
4 can do independently . 5 can teach it / handle edge cases

Claude redraws the map after every level change, and whenever you ask for progress. Levels are strict: a level goes up only after 2+ independent checks, at least one of them unprompted recall. Level 5 also needs you to handle an edge case and explain the concept well enough that Claude would trust you to teach it.


Commands You Can Use Anytime

Say this What happens
"show progress" Renders the skill map
"harder" / "easier" Adjusts question difficulty
"just tell me" Skips Socratic mode for the current question only
"save state" Outputs a compact block (topic, levels, misconceptions, what's covered) you can paste into a new session
"resume from:" + a saved block Restores the map and continues where you left off

Tips & Best Practices

  • Answer in your own words. Claude is told not to credit insight you didn't express, so vague answers get probed, not accepted.
  • Expect no flattery. Feedback like "Not quite. Why would X happen if Y were true?" is the design, not rudeness.
  • Use real exercises for technical topics. Where tools are available, Claude can ask you to write a query or predict what code prints, then check your actual output rather than your description of it.
  • Pick a narrow topic, or accept a branch. For broad subjects Claude builds a two-level tree and works one branch at a time.
  • Save state before you stop. Long courses span sessions. Paste the saved block into a new session to pick up where you left off.

Limitations

  • It's a drill, not a reference. If you only want an answer, ask a plain question or say "just tell me".
  • A mastery session takes real time. A broad topic can run for many sessions, which is why save and resume exist.
  • The skill levels are Claude's judgment from your answers. They're a useful guide, not a certification.

$Related Playbooks

Education

Study Guide Generator

Transform course materials into comprehensive study guides with summaries, practice questions, and flashcards.

5 minutes
Beginner
Education

Training Material Development

Create structured training materials, course outlines, learning objectives, and assessment tools for employee development programs.

10 minutes
Intermediate
Education

Source Code Deep Learner

Clone open-source libraries and have Claude Code teach you how complex systems work by reading the actual source code — from distributed databases to web frameworks.

5 minutes
Beginner
Education

DeepTutor: Agent-Native AI Tutoring

Set up DeepTutor — a self-hosted AI tutoring platform with RAG knowledge bases, multi-agent problem solving, quiz generation, deep research, and persistent TutorBot agents you can run from CLI or browser.

15 minutes
Intermediate
Education

E-Learning Course Creator

Plan, structure, and write complete e-learning courses with Claude Code skills for each phase — from curriculum design to lesson writing and assessment creation.

10 minutes
Intermediate
Education

Explain This: Understand Papers, Articles, and Code for Real

An explainer that builds a profile of how you learn, shapes every explanation around it, gates on comprehension quizzes, and turns the questions into a spaced-repetition deck

15 minutes
Advanced
Education

Language Vocabulary Builder

Create personalized vocabulary lists with context sentences and spaced repetition flashcards for language learning.

5 minutes
Beginner
Education

Personalized Syllabus

Deeply study a thinker, book, or topic with a reading plan tailored to your existing expertise — Claude builds the syllabus, routes every new concept through what you already know, and sits alongside you as an interactive interlocutor while you read the primary texts.

10 minutes
Intermediate

Browse all Education playbooks →