socratic-tutor: Jane Street's skill that makes your agent teach you
Added NewCopyable prompt below
Published Last verified Released
Our verdict
A small, well-written prompt with a real job: learning a new library, codebase concept or domain properly instead of skimming A.I. explanations. The rules are what make it useful: levels rise only after two independent checks, wrong answers get a narrower question rather than the answer, earlier subskills get re-tested without warning, and 'save state' gives you a block to resume in a new session. It is one skill in a new repo (created 3 Nov 2026), and it is a learning aid, not a trading or finance tool. Expect slower sessions than asking for an explanation; that's the point. We have not run it ourselves.
- Who it's for
- Builders who need to get genuinely competent in a new language, framework, domain or codebase area, and anyone who wants their agent to quiz rather than lecture
- Leverage
- A structured, self-paced course on any topic from the agent you already use, with progress you can see and resume
- Effort
- Low
- Date added
What it does
socratic-tutor (janestreet/agent_skills, MIT) is a single SKILL.md. It triggers on asks like 'teach me', 'quiz me' or 'drill me' and ignores one-off 'explain X' questions. It splits the topic into 4-10 subskills, runs a 3-5 question diagnostic, then shows an ASCII skill map with levels 0-5. The loop asks one question at a time, makes you predict, explain or spot flaws, plays devil's advocate on right answers, and sets hands-on exercises when the agent has tools (for example 'predict what this code prints'). The course ends when every subskill reaches 4/5 (5/5 on request) and you pass a mixed final assessment. Commands: show progress, harder, easier, just tell me, save state and resume from.
How builders use it
- Copy the socratic-tutor folder into your agent's skills folder (for Claude Code, ~/.claude/skills/).
- Ask 'teach me <topic>' and answer the diagnostic honestly so it starts at the right level.
- In a coding agent, point it at real files so exercises use your own codebase.
- Say 'save state' at the end of a session and paste the block with 'resume from:' next time.
What to expect
A tracked path from 'heard of it' to 'can do it independently' on a topic of your choice, with your weak spots listed at the end.
Copy this: Install + first session
# Official source: github.com/janestreet/agent_skills (MIT)
git clone https://github.com/janestreet/agent_skills.git /tmp/js-skills
cp -r /tmp/js-skills/socratic-tutor ~/.claude/skills/
# In a new session:
Teach me <topic>. Target level 4/5. Use the files in this repo for exercises where it helps.
# Plain chatbot: paste the body of socratic-tutor/SKILL.md, then 'Teach me <topic>.'
# Anytime: show progress | harder | easier | just tell me | save state | resume from: <block>Related discoveries
See the newest picks →- ToolSmall Tools, Repos & Plugins
Repomix: pack a repo into one A.I.-ready file
One command turns a local or remote repo into a single file you can hand to any LLM, with token counts.
Effort: LowPrompt#Plugin / extension#MCP
- ToolSmall Tools, Repos & Plugins
UI UX Pro Max: a design skill for coding agents
An MIT-licensed skill that gives Claude Code, Cursor and other agents a design-system generator and UI guidance.
Effort: LowPrompt#Plugin / extension#Open source
- ToolSmall Tools, Repos & Plugins
CLI-Anything: give your agent a CLI for desktop apps
Ready-made and generated command-line interfaces that let coding agents drive GIMP, Blender, LibreOffice and other software through commands with JSON output.
Effort: MediumPrompt#Plugin / extension#Open source
- ToolSmall Tools, Repos & Plugins
mattpocock/skills: make your coding agent ask first
Matt Pocock's small, composable agent skills for real engineering: grill the plan, write a spec, split tickets, then build with TDD.
Effort: LowPrompt#Plugin / extension#Open source
Get the best new A.I. picks in your inbox
The best new agent workflows and tools we’ve vetted, with a clear verdict on each. Short, occasional, useful.