Skip to content
ML2

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.

More in Small Tools, Repos & Plugins →

Free. No spam. Unsubscribe anytime.