# Jane Street Agent Skills: a strict Socratic tutor (janestreet/agent_skills) — skill card for AI agents

> AgentGid skill card. Checked on 2026-11-13 against commit 7c6715c.
> Every fact comes from the pack's own files at that commit. Numbers marked "as reported" are the author's.
> Human page: https://agentgid.com/skills/janestreet/agent_skills/

## Explain it to a non-programmer
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.

## Who it is for
- 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
- Not for: You only want a quick explanation of one thing: the tutor stays off for that
- Not for: You want the answer right away: it holds back answers and asks narrower questions first

## What it is
- Kind: knowledge
- License: MIT
- Repository: https://github.com/janestreet/agent_skills

## What it 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 0: unaware
- Level 1: heard of it
- Level 2: can follow along
- Level 3: can do with help
- Level 4: can do independently
- Level 5: can teach it / handle edge cases

## Skills
| Skill | Call | Changes code? | In plain words |
|---|---|---|---|
| socratic-tutor | plain language ("teach me ...", "tutor me ...", "quiz me ...", "drill me ...", "help me master ...") | no | Teaches you a topic of your choice by asking questions and tracking your level |

### socratic-tutor
- Asks for: The topic you want to learn
- Asks for: Your goal: the default level 4 of 5, or full mastery (5 of 5)
- Asks for: Your answers, one question at a time
- Asks for: A saved progress block, if you want to continue an earlier session
- Gives: A list of 4 to 10 parts of the topic
- Gives: A 3 to 5 question warm-up test
- Gives: A text progress map with levels 0 to 5, updated after every level change
- Gives: Questions, short explanations of new material and practical exercises
- Gives: A final mixed test and a summary of your weakest areas
- Gives: 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"

## Know before installing
- 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.

## Install (official commands)
- Coding assistant with a skills folder: 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`.
- Any chatbot (no terminal): 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.

## What runs on the user's machine
- Code on the machine: no
- Network: none
- 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.

## Examples (from the pack's own files)
- The progress map the tutor shows: output format defined in socratic-tutor/SKILL.md

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

## May I use it like this?
- commercial-app: yes (MIT: keep the copyright and permission notice)
- redistribute-files: yes (MIT: include the copyright and permission notice in copies)
- client-work: yes (MIT allows use in work for others)

## Which one to pick
- If You want to be taught a topic over time, with a placement test, levels 0 to 5, spaced re-checks and a final test: skill:janestreet/agent_skills
- If You want one explanation of anything, pitched to a given audience (kids, managers, engineers): skill:DreambigOu/ELI5
- If You want to learn from the code your AI assistant just wrote: skill:mohi-devhub/antivibe
- If You want to turn a technical book PDF into a skill to study from: skill:virgiliojr94/book-to-skill

## Works in and needs
- Works in Any coding agent that reads SKILL.md: skills folder
- Works in Any chatbot: pasted into the chat or a custom/system prompt

## How to tell it works
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.
