GitHub radar

Turn your AI chat into a strict Socratic tutor for any topic

This is a ready-made instruction for your AI agent: send it, and your chatbot starts teaching your chosen topic by asking questions instead of lecturing, until you actually understand it.

A text instruction file for an AI agent (Claude Code, Codex, any chatbot) that turns it into a tutor: instead of explaining, it asks questions using the Socratic method and tracks your progress by subtopic.

When it helps

Useful if you're learning alone with no one to ask for explanations; skip it if you just want a quick direct answer instead of a step-by-step dialogue.

Pros

  • Never hands you the answer — makes you reason it out yourself
  • Tracks progress per subtopic on its own 0–5 skill scale
  • Works in any chat with system prompts or files, no install needed
  • Only advances once you answer correctly twice in a row

Cons

  • Quality depends entirely on the underlying chatbot, nothing checks it
  • Only one skill exists so far — tutoring, nothing else to pick
  • Not for you if you want fast direct answers, not dialogue

How to set it up — step by step

  1. 1Open your AI agent (Claude Code, Codex, or any chatbot) in your project folder.
  2. 2Send the agent the text from the block below, filling in your own topic.
  3. 3Answer the 3–5 opening questions — the agent uses them to gauge your starting level.
  4. 4Answer one subtopic's questions at a time, without guessing or peeking ahead.
  5. 5Watch the progress bar for each subtopic as its 0–5 level moves up.
  6. 6If you're stuck, read the rephrased hints instead of asking for the answer outright.

Text for your agent

Copy this and send it to your agent — Claude Code, Codex, any of them:

Take the SKILL.md file for the socratic-tutor skill from the janestreet/agent_skills repository, load it for me as a system instruction (or drop it into the agent's skills folder), then start teaching me the Socratic way on the topic "<fill in your topic>": ask one question at a time and don't give away the answer right away.

Runs on a regular laptop — it's a text instruction file you paste into your AI agent's chat, no separate install or GPU needed.

Open on GitHub