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
1. Changes your files
None of its skills edits your files.
github.com/janestreet/agent_skills/blob/7c6715c/2. Runs code on your machine
Install: One markdown file with instructions. No hooks, no scripts, no settings. During a session: Only 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.
github.com/janestreet/agent_skills/blob/7c6715c/3. Sends data
github.com/janestreet/agent_skills/blob/7c6715c/4. Commercial use
MIT: keep the copyright and permission notice
github.com/janestreet/agent_skills/blob/7c6715c/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
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.
| Repository | janestreet/agent_skills |
|---|---|
| GitHub stars | 8,712 |
| Skills | 1 |
| Category | Planning, memory and productivity |
| License | MIT |
| Last updated | Nov 3, 2026 · card checked Nov 13, 2026 at commit 7c6715c |
| Install counts | janestreet/agent_skills on skills.sh, Vercel's skills directory, which shows installs and security audits per skill |
janestreet/agent_skills popularity over time
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
| Level | Behaviour |
|---|---|
| 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 |
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
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 want | Use |
|---|---|
| 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) |
Skills in janestreet/agent_skills
| Skill | In plain words | Changes files? | What it does (author) |
|---|---|---|---|
| socratic-tutor | Teaches you a topic of your choice by asking questions and tracking your level | No | 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 loopExpect 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 continueKeep 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 ideaExpect 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 need | Pick |
|---|---|
| You want to be taught a topic over time, with a placement test, levels 0 to 5, spaced re-checks and a final test | This 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 wrote | mohi-devhub/antivibe |
| You want to turn a technical book PDF into a skill to study from | virgiliojr94/book-to-skill |
May I use it like this?
| Use | Answer | Condition |
|---|---|---|
| In a commercial app | Yes | MIT: keep the copyright and permission notice |
| Passing the files on | Yes | MIT: include the copyright and permission notice in copies |
| Work for clients | Yes | MIT 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
Paste the body of socratic-tutor/SKILL.md into the chat or into a custom or system prompt, then say what you want to learn.
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
| When | What happens |
|---|---|
| Install | One markdown file with instructions. No hooks, no scripts, no settings. |
| During a session | Only 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
| # | 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 |