oh-my-study-with-me
First Principles learning plugin for Claude Code.
Research multiple sources. Study deeply. Validate your understanding. Write clearly.
Get Started
Step 1: Register the marketplace
/plugin marketplace add https://github.com/lsh1215/oh-my-study-with-me
Step 2: Install the plugin
/plugin install oh-my-study-with-me
That's it. Start studying. The short alias is swm.
What It Does
| When You... | It Automatically... |
|---|---|
| Give it URLs to research | Fetches all sources, cross-analyzes, produces a synthesis |
| Open a book PDF | Extracts principles, starts Socratic dialogue |
| Say "study this article" | Fetches the URL, extracts structure, deep dives into it |
| Point it at a GitHub repo | Analyzes architecture, README, key design decisions |
| Finish a chapter | Validates with Feynman test, code challenge, or design problem |
| Get something wrong | Tracks the weak concept, revisits it next session |
| Want to write about it | Drafts a blog with Toulmin argumentation, saves to Notion |
| Want hands-on practice | Spins up a Docker lab with monitoring |
You don't need to memorize commands. Just describe what you want in natural language.
Skills
| Skill | What It Does |
|---|---|
research | Multi-source research & synthesis — URLs, GitHub repos, web search, cross-analysis |
study | Deep learning session — PDF/URL/GitHub reading, First Principles dialogue, type-based validation, metacognition tracking |
study-vault | Pre-study note generation — dashboard, quick-reference, concept-compare, practice problems. Supports PDF, URL, GitHub |
setup-quiz | ⚠️ Experimental — Slack daily quiz system, GitHub Actions + Leitner spaced repetition |
blog | Technical blog writing — Orwell clarity, Toulmin argumentation, Steel Man rebuttal, Notion integration |
lab | Docker lab environments — Kafka, ES, MySQL, Redis with Prometheus + Grafana |
How to Invoke
Four ways to call any skill:
swm prefix (recommended)
swm:research kafka consensus
swm:study kafka
swm:study https://article.com/deep-dive
swm:blog kafka producer
swm:lab redis
Slash commands (explicit)
/oh-my-study-with-me:research kafka
/oh-my-study-with-me:study kafka
/oh-my-study-with-me:blog kafka producer
Colon patterns (bare skill name)
research : kafka consensus
study : kafka
blog : kafka producer
lab : redis
Natural language (just talk)
Research these articles about Kafka consensus
Let's study the Kafka book
Study this GitHub repo
Write a blog post about producers and save to Notion
Spin up a Redis lab
Works in both English and Korean.
Source Support
| Source Type | research | study | study-vault |
|---|---|---|---|
| Multiple URLs | ✅ Primary | — | — |
| Single Web URL | ✅ | ✅ | ✅ |
| GitHub repo | ✅ | ✅ | ✅ |
| YouTube (best-effort) | ✅ | ✅ | — |
| — (use study) | ✅ | ✅ | |
| Freeform text | ✅ | ✅ | — |
Workflow
research ─── Gather and synthesize from multiple sources
└── Research summary + source notes
↓
study-vault ─── Grasp the source structure first
└── Dashboard + Quick-Reference + Concept-Compare + Practice
↓
study ─── Deep dive into each section (🟦🟩🟨🟥⬜ metacognition)
├── Validation → quiz_bank.json
│ ↓
│ setup-quiz ─── Daily Slack quizzes via GitHub Actions
│
├── "I want to try it" → lab
│ ↓
│ lab ─── Docker Compose → Monitor → Observe → Analyze
│
└── Study memo → study-notes/
↓
blog ─── Skeleton → Draft → Kill Your Darlings → Notion
Metacognition Tracking
Every concept you study is tracked individually:
| Badge | Meaning | Accuracy |
|---|---|---|
| 🟦 | Mastered | 90%+ (3+ attempts) |
| 🟩 | Good | 70-89% |
| 🟨 | Average | 40-69% |
| 🟥 | Weak | 0-39% |
| ⬜ | Not tested | — |
Weak concepts are automatically prioritized in your next session.
Requirements
- Claude Code CLI
- PDF, URL, or GitHub repo as study material (any one is enough)
- Docker (for
labskill only) - Slack + GitHub Actions (for
setup-quizskill only) - Notion MCP (for
blogNotion integration — optional, falls back to local file)