A study coach for Claude Code
The study coach that builds memory, not dependence.
Socrates coaches with questions, retrieval practice, and spaced review — the methods the learning research supports. It studies with you, or coaches you while you drive. It will not hand you the answer, because retrieving it yourself is what builds the memory.
Using Socrates
Open Claude Code and say what you’re studying. Paste your notes, share a link or a photo of a problem, or just name the topic:
- “Help me study for my biology test on cellular respiration.”
- “I don’t get this.” (then paste your notes)
- “Quiz me on the French Revolution.”
- “Make me a study plan for finals.”
What happens in a session
- It loads your profile. The first time, it asks four quick questions — your name, your grade or year, your subjects, and anything about how you learn — and saves a profile.
- Reviews come first. Anything due for review gets a short retrieval check before any new material.
- It takes in what you brought: notes, a reading, slides, a photo, a link, a problem set (which it will not solve for you), or just a topic.
- It chooses a technique for the subject and your goal, and tells you which one and why — and where to find it in the study guide. If there’s a test, the date shapes the plan.
- You choose the mode. Study with me: it runs the technique and quizzes you as you go. Coach me: you do the work, and it sets up the practice and checks what you produce.
- The session runs retrieval-first. Gaps get worked and answers get earned. “I get it” is checked with recall, notes closed.
- It closes the loop. The session is logged and your next reviews are scheduled: Day 2, 5, 12, and 30, then monthly — or a short review every day when a test is sooner than that.
What a session sounds like
Student I have a bio quiz Friday. Can you just explain cellular respiration?
Socrates We’ll get there, but you go first. Notes closed: what do cells get out of breaking down glucose?
Student ATP. And it needs oxygen — is that why we breathe?
Socrates Yes. And you pulled that from memory, which is what makes it stick. Next: what happens when there isn’t enough oxygen?
The study guide
Socrates is built on How to Actually Study: fourteen techniques and how to apply each one, what works for each subject, adaptations for ADHD, dyslexia, anxiety, autism, and dyscalculia, how to build a study system, and a one-page cheat sheet. The whole guide installs with the skill, so it is on your computer and works offline. Ask Socrates for it (“show me the study guide”), or open study-guide.html in the skill’s folder.
Where your progress is saved
Each student gets a profile: a plain text file with their subjects, what is working, and the review schedule. Profiles live outside the skill’s folder, so updating or reinstalling never touches them, and a parent or student can open one and read it at any time.
Windows: %USERPROFILE%\.claude\socrates\profiles\
macOS and Linux: ~/.claude/socrates/profiles/
Install
The only requirement is Claude Code. Socrates is plain text — no Python, no Node, no accounts — and nothing it saves leaves your computer.
git clone https://github.com/BourbonDog/Socrates.git
cd Socrates
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills\socrates" | Out-Null
Copy-Item -Recurse -Force ".\skills\socrates\*" "$env:USERPROFILE\.claude\skills\socrates"
git clone https://github.com/BourbonDog/Socrates.git
cd Socrates
mkdir -p ~/.claude/skills/socrates && cp -R skills/socrates/. ~/.claude/skills/socrates/
This puts one folder, socrates, in your Claude skills folder: the coaching instructions, their reference notes, and the study guide — study-guide.html for you to read, study-guide.md for Socrates. No Git? Download the repository as a ZIP from GitHub, unzip it, and run the copy commands from inside it. Then open Claude Code and say what you’re studying.
To update, pull the latest version (or download it again) and run the same commands. Your profiles are left alone.