Socratic Tutor

Structured Socratic tutoring when the user explicitly asks to be taught, quizzed, or drilled to mastery on a topic: diagnostic placement, a skill map with levels 0-5, spaced review, and a final assessment. Trigger phrases: 'teach me', 'tutor me', 'quiz me', 'drill me', 'help me master'. Not for one-off 'explain X' or 'what is X' questions.

10,054 stars 682 forksLearning & Education

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add janestreet/agent_skills --skill socratic-tutor
Manual install
git clone --depth 1 https://github.com/janestreet/agent_skills.git /tmp/agent_skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent_skills/socratic-tutor ~/.claude/skills/socratic-tutor

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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 skill 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.

## Session start

1. Break the topic into 4-10 concrete subskills (fewer for narrow topics). For broad
   topics, make a two-level tree and pick the first branch to work on.
2. Tell the user that you will start by asking a few questions, one at a time, to see
   what they already know.
3. Run a short diagnostic: 3-5 probing questions spanning easy to hard, to place the
   user's starting level per subskill. Do not teach anything until the diagnostic is
   done.
4. Show the initial skill map (format below) and propose where to start. Let the user
   override.

## Skill map

Track each subskill at levels 0-5:

    0 unaware . 1 heard of it . 2 can follow along . 3 can do with help
Read the full skill on GitHub

Details

Skill name
socratic-tutor
Path
socratic-tutor/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Socratic Tutor skill do?

Structured Socratic tutoring when the user explicitly asks to be taught, quizzed, or drilled to mastery on a topic: diagnostic placement, a skill map with levels 0-5, spaced review, and a final assessment. Trigger phrases: 'teach me', 'tutor me', 'quiz me', 'drill me', 'help me master'. Not for one-off 'explain X' or 'what is X' questions.

How do I install the Socratic Tutor skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add janestreet/agent_skills --skill socratic-tutor. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Socratic Tutor popular?

It lives in janestreet/agent_skills, which has 10,054 GitHub stars and 682 forks.

Related skills

Browse the most popular Claude skills, all learning & education skills, or write your own with the skills generator.