🏛️ Socrates.ai

Your AI learning companion that makes you think, not just read.

Socrates.ai is a set of Claude Code skills that turn any Obsidian vault into a Socratic learning system. It researches topics, generates lessons, and then — instead of just answering your questions — challenges your thinking through guided dialogue.

"I cannot teach anybody anything. I can only make them think." — Socrates

How it works

You: "帮我研究 distributed systems"
  → Generates 5-6 structured lessons from YouTube talks, papers, and web sources

You: "Raft的leader election怎么工作的？"
  → Expert mode: clear technical explanation

You: "我觉得Raft比Paxos好因为更简单"
  → Socratic mode: "更简单是一个优点，但想想看——有没有场景下
    Paxos的灵活性反而是必须的？Raft的限制是什么？"

You: "ok"
  → 💡 Saved as a lightbulb note, linked back to the lesson

Every discussion creates a 💡 lightbulb note — a record of your active thinking. Wrong about something? The 🔄 mindshift is captured too. Over time, your vault becomes a knowledge graph of everything you've genuinely understood.

Features

• Three learning modes: Expert (direct answers), Socratic (guided questioning), Research (deep-dive)
• 💡 Lightbulb notes: Every discussion consolidates into a linked note in your vault
• 🔄 Mindshift tracking: Wrong beliefs → correct understanding, captured as learning evidence
• Gamification: 🌱 Seed → 🌾 Wheat → 🍞 Bread per project. Levels from 📖 Apprentice to 📜 Plato
• Daily Quiz + Baking Exam: Spaced review based on your actual misconceptions
• Research Pipeline: YouTube ASR + academic papers + NotebookLM → structured curriculum
• Cross-session memory: Remembers what you've learned, what you got wrong, where you left off

Installation

# 1. Install dependencies
pip install yt-dlp

# 2. Copy skills into your vault
cp -r .claude/skills/ /path/to/your/vault/.claude/skills/

# 3. Open your vault with Claude Code and start learning

Requirements

• Claude Code (CLI)
• Obsidian (for viewing the knowledge graph)
• Python 3.9+
• yt-dlp (for YouTube transcript extraction)
• notebooklm CLI (optional, for NotebookLM integration)

Project structure

.claude/skills/
├── study-assist/          ← Socratic learning engine (core)
│   ├── SKILL.md           ← Behavior specification
│   └── scripts/
│       ├── locate.py      ← Fast vault content locator
│       ├── rename_task.py ← Task folder rename handler
│       └── normalize_wikilinks.py
├── research-pipeline-v2/  ← Curriculum generator
│   ├── SKILL.md
│   └── references/
├── youtube-search/        ← YouTube metadata extractor
└── notebooklm-notebook/   ← NotebookLM CLI wrapper

Philosophy

Most learning tools give you knowledge. Socrates.ai helps you give birth to your own understanding.

The AI doesn't teach — it asks questions, challenges assumptions, and guides you to figure things out yourself. Every "aha moment" is yours, not the AI's.

License

MIT

Contributing

Issues and PRs welcome. If you build something cool with these skills, let us know.