Jane Street's socratic-tutor skill for Claude Code: what it does and how to install it
Published · Last updated
Short answer
Jane Street's agent_skills repository holds one skill, socratic-tutor, MIT licensed. It teaches a topic by asking questions, tracks a skill map at levels 0 to 5, and ends with a final assessment. For Claude Code, copy its folder into ~/.claude/skills/.
Version read. This page quotes the repository at commit 7c6715c, dated 2026-11-03 17:53 UTC. It was the newest commit on the default branch when we checked on 2026-11-12. The repo has no tags or releases, so a commit is the only thing you can pin to. Every quote below links to its lines at that commit.

What the skill is
The repo is janestreet/agent_skills, owned by the Jane Street GitHub organization. Its README calls it "A collection of skills for AI agents and chatbots" where "Each skill is a directory containing a SKILL.md file with instructions for the agent" (README). At 7c6715c there is one skill folder, socratic-tutor/, and it holds only SKILL.md. That is the same SKILL.md format Anthropic donated to the Agentic AI Foundation (our guide to that change).
The skill's frontmatter, quoted:
name: "socratic-tutor"
description: "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."(SKILL.md)
Its first instruction: "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" (SKILL.md).
How a session works
This is what the SKILL.md tells the agent to do, in order.
- Check intent. For a one-off question, "answer it normally and do not start the tutoring loop". If it is unclear, ask one short question first (SKILL.md).
- Map the topic. Split it into 4 to 10 subskills, then run a diagnostic of "3-5 probing questions spanning easy to hard". "Do not teach anything until the diagnostic is done." (SKILL.md)
- Teach by questions. "Ask ONE question at a time." When you are wrong, "do not give the answer", ask a narrower question instead, and "Only explain directly after 2-3 failed attempts" (SKILL.md).
- Grade strictly. "Levels are earned, not given." A level goes up only after "2+ independent checks", and earlier subskills come back in spaced review without warning (SKILL.md).
- Finish with a test. "The course ends only when every subskill is at the target level (default 4/5; 5/5 if the user asked for full mastery)", followed by a final mixed assessment (SKILL.md).
The skill map levels
| Level | Meaning, as SKILL.md words it |
|---|---|
| 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 |
Commands you can type at any time
show progressdraws the skill mapharder / easierchanges the difficultyjust tell meturns off the Socratic mode for the current question onlysave stateprints a short block with the topic, the map and notes, to paste into a new sessionresume from:followed by a saved block, picks up where you left off
Source: SKILL.md lines 93 to 102.
Install it in Claude Code, pinned to one commit
The README's install step, quoted: "With a coding agent that supports the common SKILL.md format, copy the skill directory into your agent's skills folder, then ask the agent to use it ("teach me X")." (README) It names no command, version or package manager. For a plain chatbot it says to paste the body of the SKILL.md into the chat or a system prompt (README).
Claude Code's skills docs say where that folder is. A personal skill lives at ~/.claude/skills/<skill-name>/SKILL.md and loads in "All your projects on this machine". A project skill lives at .claude/skills/<skill-name>/SKILL.md and loads in "Sessions in this repository". These commands copy the folder at commit 7c6715c into your personal skills:
git clone https://github.com/janestreet/agent_skills.git
cd agent_skills
git checkout 7c6715c29548a3b39d4a9545c698ee4fd17a7213
mkdir -p ~/.claude/skills
cp -R socratic-tutor ~/.claude/skills/For one repository only, copy socratic-tutor into that repository's .claude/skills/ instead. The docs say Claude Code "picks up the change within the current session, without a restart" (live change detection).
Then use it. The docs say "Claude uses skills when relevant, or you can invoke one directly with /skill-name", and that "The directory name, or the frontmatter name when you set one, becomes the command you type" (code.claude.com). Here both are socratic-tutor, so type /socratic-tutor, or ask "teach me" plus your topic.
Checked with our SKILL.md validator
We ran the file at 7c6715c through the same code that powers our SKILL.md validator, with the folder name socratic-tutor. It passed: 16 checks passed, 0 failed, 0 warnings. The other 4 checks were skipped because the file does not set the optional license, compatibility, metadata or allowed-tools fields. The name matches the folder, the description is 341 of 1,024 characters, and the file is 102 lines with a body of about 1,209 tokens (the validator's estimate, characters divided by 4).
The missing license field is not a gap in the repo. The license is in LICENSE.md at the repo root, which the validator does not read.
License
LICENSE.md opens with "The MIT License" and "Copyright (c) 2026 Jane Street Group, LLC" (LICENSE.md). The MIT terms let you copy and modify the skill as long as the copyright and permission notice come with it. CONTRIBUTING.md says pull requests are welcome and must be signed off under the Developer Certificate of Origin (CONTRIBUTING.md).
What we ran and what we did not
We ran the validator check above. We did not run a tutoring session, so this page says nothing about how well the skill teaches. Everything else is quoted from the repository at 7c6715c and from Claude Code's docs.
How this page was checked
On 2026-11-12 we read the repository through the GitHub API: owner janestreet (an organization), license MIT, default branch master, two commits, no tags, no releases. The files at 7c6715c are .gitignore, .ocamlformat, CONTRIBUTING.md, LICENSE.md, README.md and socratic-tutor/SKILL.md. Skill locations and invocation come from code.claude.com, read the same day.
FAQ
What is Jane Street's socratic-tutor skill?
A single SKILL.md file in the janestreet/agent_skills repository. The README says it "turns an LLM into a strict personal tutor that teaches a topic of your choice using the Socratic method" (README). It is the only skill in the repo at commit 7c6715c.
How do I install it in Claude Code?
The README says to copy the skill directory into your agent's skills folder (README). For Claude Code that folder is ~/.claude/skills/ for all your projects, or .claude/skills/ inside one repository (Claude Code docs). The commands above pin the copy to commit 7c6715c.
How do I start a tutoring session?
Ask for it in plain words, for example "teach me SQL joins", or type /socratic-tutor. The skill's description lists the trigger phrases 'teach me', 'tutor me', 'quiz me', 'drill me' and 'help me master' (SKILL.md).
Will it turn every question into a quiz?
It should not. The skill says that for a one-off question it should "answer it normally and do not start the tutoring loop", and ask one short question first when your intent is unclear (SKILL.md).
Can I stop and continue later?
Yes. Say "save state" to get a block you can paste into a new session, then start that session with "resume from:" and the block (SKILL.md).
What license is it under?
MIT. LICENSE.md starts with "The MIT License" and names Jane Street Group, LLC as the copyright holder (LICENSE.md).
Sources
All checked 2026-11-12.
- socratic-tutor SKILL.md at 7c6715c: https://github.com/
janestreet/ agent_skills/ blob/ 7c6715c29548a3b39d4a9545c698ee4fd17a7213/ socratic-tutor/ SKILL.md - README at 7c6715c: https://github.com/
janestreet/ agent_skills/ blob/ 7c6715c29548a3b39d4a9545c698ee4fd17a7213/ README.md - LICENSE.md at 7c6715c: https://github.com/
janestreet/ agent_skills/ blob/ 7c6715c29548a3b39d4a9545c698ee4fd17a7213/ LICENSE.md - CONTRIBUTING.md at 7c6715c: https://github.com/
janestreet/ agent_skills/ blob/ 7c6715c29548a3b39d4a9545c698ee4fd17a7213/ CONTRIBUTING.md - Commit 7c6715c, dated 2026-11-03 17:53 UTC: https://github.com/
janestreet/ agent_skills/ commit/ 7c6715c29548a3b39d4a9545c698ee4fd17a7213 - Claude Code skills docs: https://code.claude.com/
docs/ en/ skills