Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

Jane Street Agent Skills: a strict Socratic tutor

janestreet/agent_skills

Your AI assistant becomes a strict personal tutor for any topic you pick. It finds out what you already know, then teaches mostly by asking you questions, one at a time, and only moves you up a level when you prove it. It ends with a final test.

Pack description by its author: “Your AI assistant becomes a strict personal tutor for any topic you pick. It finds out what you already know, then teaches mostly by asking you questions, one at a time, and only moves you up a level when you prove it. It ends with a final test.”

Planning, memory and productivityKnowledge and rules for your assistant

GitHub

Checked against the pack's files at commit 7c6715c, on Nov 13, 2026. Tap a verdict to see its source.How we checkedReport an error

Knowledge and rules for your assistantNothing to run: text files only

Good for you if

  • You want to really learn a topic, not just get a quick answer
  • You like being quizzed and want honest feedback instead of praise
  • You use a coding assistant that reads skill folders, or any chatbot you can paste text into

Probably not for you if

  • You only want a quick explanation of one thing: the tutor stays off for that
  • You want the answer right away: it holds back answers and asks narrower questions first

What its answer looks like

The progress map the tutor shows

Topic: <topic>                          overall: ######.... 58%
-----------------------------------------------------------------
subskill A            [########..]  4/5  * independent
subskill B            [######....]  3/5  <- current focus
subskill C            [##........]  1/5
-----------------------------------------------------------------

The skill's own example, from socratic-tutor/SKILL.md. More examples

What you'll notice

  • A few warm-up questions first, to see where you stand, before any teaching
  • A progress map of the topic with a level from 0 to 5 for each part
  • One question per message, then it waits for your answer
  • Surprise re-checks of earlier parts, and a final mixed test at the end

What you need

  • Coding assistants that read skill folders, Any chatbot (paste the text)
  • Free, MIT license
  • Copy one folder into your assistant's skills folder, or paste one text file into a chat
Words on this page
Skill
A set of written instructions your AI assistant follows. Installing one is like giving it a playbook.
Repositoryjanestreet/agent_skills
GitHub stars8,712
Skills1
CategoryPlanning, memory and productivity
LicenseMIT
Last updatedNov 3, 2026 · card checked Nov 13, 2026 at commit 7c6715c
Install countsjanestreet/agent_skills on skills.sh, Vercel's skills directory, which shows installs and security audits per skill

janestreet/agent_skills popularity over time

Most starred skill packs

janestreet/agent_skills: GitHub starstotal over time 8,712

What Jane Street Agent Skills does

  • Checks first: if you asked a one-off question it just answers; if unclear, it asks whether you want a quick answer or real teaching
  • Splits the topic into 4 to 10 parts (a two-level tree for broad topics) and runs a 3 to 5 question warm-up test
  • Shows a progress map and proposes where to start; you can choose a different starting point
  • Teaches by questions: predict, explain why, find the flaw, apply to a new case, connect two ideas
  • When you are wrong it asks a narrower question; it explains directly only after 2 to 3 failed tries, then re-tests
  • Short explanations only for genuinely new material; practical exercises when the assistant can run tools
  • Raises a level only after 2 or more separate checks, one of them recall from memory
  • Finishes with a mixed final test and a summary of your weakest areas
LevelBehaviour
0unaware
1heard of it
2can follow along
3can do with help
4can do independently
5can teach it / handle edge cases

From the pack's SKILL.md files, summarised by AgentGid.

The skill, explained

socratic-tutor

Teaches you a topic of your choice by asking questions and tracking your level

You give

  • The topic you want to learn
  • Your goal: the default level 4 of 5, or full mastery (5 of 5)
  • Your answers, one question at a time
  • A saved progress block, if you want to continue an earlier session

You get

  • A list of 4 to 10 parts of the topic
  • A 3 to 5 question warm-up test
  • A text progress map with levels 0 to 5, updated after every level change
  • Questions, short explanations of new material and practical exercises
  • A final mixed test and a summary of your weakest areas
  • A compact progress block on request, to paste into a new session
Say: “Teach me how SQL joins work, I want to really master it”

See it in action

The skill defines what its answer looks like. Its own example:

Topic: <topic>                          overall: ######.... 58%
-----------------------------------------------------------------
subskill A            [########..]  4/5  * independent
subskill B            [######....]  3/5  <- current focus
subskill C            [##........]  1/5
-----------------------------------------------------------------

From socratic-tutor/SKILL.md.

When to reach for it

You wantUse
To learn a topic properly from where you are now"teach me <topic>" or "tutor me on <topic>"
To see how far you have come"show progress"
Questions that are too easy or too hard"harder" or "easier"
The answer to the current question without more questions"just tell me" (for this question only)
To stop now and continue later"save state", then "resume from:" plus the saved block in a new session
A quick explanation only"explain X" or "what is X" (the tutor stays off)
Try it. Install it, then say "teach me" plus a topic you half know. The assistant should first ask a few questions one at a time, then show a progress map with levels 0 to 5. If it starts lecturing right away, the skill is not loaded.

Skills in janestreet/agent_skills

SkillIn plain wordsChanges files?What it does (author)
socratic-tutor Teaches you a topic of your choice by asking questions and tracking your levelNo 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…
npx skills add janestreet/agent_skills --skill socratic-tutor

The author's descriptions come from each skill's SKILL.md; the plain-words column is AgentGid's.

Good to know before you install

  • It does not start by itself on simple questions: "explain X" or "what is X" gets a normal answer, and an unclear request gets one short question first.
  • It is strict on purpose: no praise for half-right answers, and levels can go down after a failed re-check.
  • It tells the assistant not to flatter you.
  • Progress is not saved anywhere on its own. Say "save state", keep the block it prints, and paste it after "resume from:" in a new session.
  • When the assistant can run tools, it may set real exercises and check your actual output, not your description of it.
  • The whole pack is one instruction file in one folder. Nothing is installed and no code runs.

Before you start

Works in

  • Any coding agent that reads SKILL.md: skills folder
  • Any chatbot: pasted into the chat or a custom/system prompt

Mistakes to avoid

  • Ask "explain X" or "what is X" and expect a tutoring session
    Say "teach me", "tutor me", "quiz me", "drill me" or "help me master" plus the topic
    The skill answers one-off questions normally and does not start the tutoring loop
  • Expect the tutor to remember your levels in a new session
    Say "save state" before you stop, keep the block, then start the next session with "resume from:" and the block
    The skill keeps no file; the saved block is the only way to continue
  • Keep giving wrong answers and wait for the tutor to reveal the right one
    Say "just tell me" when you want a direct answer to the current question
    It explains directly only after 2 to 3 failed attempts, and then re-tests the same idea
  • Expect the course to finish after one short chat
    Plan for several sessions; the course ends only when every part reaches the target level and the final test is passed
    Levels need 2 or more separate checks and spaced re-tests can lower them

Which one to pick

If you needPick
You want to be taught a topic over time, with a placement test, levels 0 to 5, spaced re-checks and a final testThis pack
You want one explanation of anything, pitched to a given audience (kids, managers, engineers)DreambigOu/ELI5
You want to learn from the code your AI assistant just wrotemohi-devhub/antivibe
You want to turn a technical book PDF into a skill to study fromvirgiliojr94/book-to-skill

May I use it like this?

UseAnswerCondition
In a commercial app YesMIT: keep the copyright and permission notice
Passing the files on YesMIT: include the copyright and permission notice in copies
Work for clients YesMIT allows use in work for others

Install Jane Street Agent Skills

Official commands from the repository

Copy the socratic-tutor folder into your assistant's skills folder, then ask it to teach you something. The repository gives no exact commands.

Remove: Delete the socratic-tutor folder from the skills folder

Or with the open-source skills CLI: npx skills add janestreet/agent_skills. Skills are instructions your agent follows: read them before installing.

What it installs and runs on your machine

Read in the code at commit 7c6715c, Nov 13, 2026

WhenWhat happens
InstallOne markdown file with instructions. No hooks, no scripts, no settings.
During a sessionOnly if your assistant can run tools, the skill may ask it to set practical exercises (for example a query or a piece of code) and check your real output.

Quick answers

Is it free?
Yes. MIT license, from Jane Street.
Does it work without a coding assistant?
Yes. Paste the body of SKILL.md into any chatbot, or into its custom or system prompt.
Will it remember my progress next time?
Not by itself. Say "save state" and paste the block into a new session after "resume from:".
Can I get a straight answer when I am stuck?
Yes. Say "just tell me"; it answers that one question directly and then goes back to questions.
When does the course end?
When every part of the topic reaches the target level (4 of 5 by default) and you pass a final mixed test.
Does it send my data anywhere?
No. It is a text file with instructions and contains no code.

Checked by AgentGid on Nov 13, 2026 against commit 7c6715c of the pack's own files. agent.md for AI agents · Report a mistake

More planning, memory and productivity skill packs

All planning, memory and productivity skills

# Skill pack Skills GitHub stars Updated
1
career-ops-hq/career-ops Your AI assistant becomes a job search helper that works from a folder on your computer. Paste a job link and it checks the job i…
1 82.6K 2026-11-15
2
ayghri/i-have-adhd Your AI assistant puts the next thing to do on the first line. It numbers the steps, gives time in minutes or hours, says where y…
1 61.2K 2026-10-19
3
obsidianmd/obsidian-skills Seven skills from the Obsidian team that teach your AI assistant how Obsidian works. It writes notes, table and board views and c…
7 52.7K 2026-11-11
4
sickn33/agentic-awesome-skills A very large library of ready instructions for AI assistants: about 2,750 skills for coding, debugging, security, marketing, SEO,…
2956 49.7K 2026-11-14
5
AgriciDaniel/claude-obsidian Your assistant turns the articles, papers and notes you drop into a folder into linked, cited notes in an Obsidian vault. You can…
16 16.5K 2026-10-25
6
nidhinjs/prompt-master Your assistant turns a rough idea into one finished prompt for the AI tool you name: ChatGPT, Cursor, Claude Code, Midjourney, So…
1 16K 2026-10-22