MMCPMarkets
KC

kirilxd/claude-tutor

Developer tools
114 stars 품질 40 트렌드 40
Repository Install

claude-tutor Turn Claude Code into your personal tutor — with spaced repetition.

개요

claude-tutor Turn Claude Code into your personal tutor — with spaced repetition.

README

claude-tutor Turn Claude Code into your personal tutor — with spaced repetition.

Get started in 10 seconds

/plugin marketplace add kirilxd/claude-tutor
/plugin install claude-tutor@kirilxd-plugins

Then just say:

teach me about Kubernetes

What it does

Claude Tutor creates personalized learning plans, quizzes you with adaptive difficulty, and schedules reviews using SM-2 spaced repetition — all inside Claude Code. Works with any topic: programming, system design, DevOps, languages, science, history, music theory.

No slash commands needed. Just talk naturally:

Say this Claude does this
“teach me about recursion” Creates a learning plan with curated resources
“quiz me on networking” Adaptive quiz targeting your weak areas
“how well do I know Python” Progress report with study recommendations
“find me resources on Rust” Curated materials grouped by module
“open dashboard” Launches web UI at localhost:3847

The learning cycle

plan → study → quiz → review → repeat
  1. Plan — /learn researches your topic and builds a structured plan with modules, concepts, and curated resources
  2. Study — Claude teaches each module interactively with analogies, examples, and comprehension checks
  3. Quiz — /quiz tests you with mixed formats (MCQ, true/false, short answer, fill-in-blank) that adapt to your level
  4. Review — SM-2 spaced repetition schedules concept reviews at optimal intervals (1d → 6d → 15d → …)
  5. Repeat — /review shows progress and recommends what to study next

Key features

Feature Details
🧠 SM-2 spaced repetition Industry-standard algorithm schedules reviews right before you forget
📊 Adaptive difficulty Questions get harder as you improve, easier when you struggle
🎯 Weak area targeting Quizzes prioritize concepts you’ve gotten wrong before
👤 Learner profiles Remembers your style (hands-on, visual, theory-first) across all topics
🔍 Diagnostic assessment Calibrates your actual level so you skip what you already know
🔔 Session-start reminders Shows overdue reviews every time you open Claude Code
🛡️ Schema enforcement PreToolUse hooks prevent data corruption automatically
🌐 Web dashboard Full visual interface — create plans, take quizzes, view calendar

Web dashboard

A local web UI at http://localhost:3847 with everything you need:

View What it does
Overview All topics, stats, overdue alerts, study recommendations
Create Topic Build a learning plan via form — Claude researches and generates it
Take Quiz Interactive MCQ/True-False quiz with instant feedback
Plan Viewer Browse modules, reorder them, view resources
Progress Score trend chart, quiz history, spaced repetition schedule
Calendar Monthly view of upcoming and overdue reviews
Profile Edit learning style and background preferences

The dashboard and CLI share the same data. Switch between them freely.

Commands

Command Description Example
/learn Create a learning plan with web research /learn Kubernetes
/quiz [topic] Take an adaptive quiz /quiz or /quiz DNS
/review [topic] View progress and recommendations /review
/resources Get curated learning resources /resources system design
/dashboard Launch the web dashboard /dashboard

Your data stays local

All data is stored on your machine. Nothing is sent to external services.

~/.claude/learning/
├── index.json              # topic registry
├── profile.json            # learner preferences
├── plans/
│   └── -.json # learning plans
└── progress/
    └── .json        # quiz results, spaced repetition schedules

Development

claude-tutor/
├── .claude-plugin/
│   ├── plugin.json         # plugin manifest
│   └── marketplace.json    # marketplace definition
├── commands/               # slash command definitions
├── skills/                 # skill instructions (SKILL.md files)
│   ├── learn/
│   ├── quiz/
│   ├── review/
│   ├── resources/
│   └── dashboard/server/   # Express server + vanilla JS frontend
├── hooks/                  # PreToolUse + SessionStart hooks
├── tests/                  # hook unit tests
└── evals/                  # trigger + functional evaluations

Running tests

node tests/test-hooks.js                              # hook unit tests (27 tests)
./evals/run-trigger-eval.sh                           # trigger evals (17 prompts)
./evals/run-functional-eval.sh                        # end-to-end evals (21 checks)
node skills/dashboard/server/tests/dashboard.test.js  # dashboard tests (30 scenarios)

Known limitations

Limitation Details
Quiz formats Dashboard supports MCQ and True/False only. Short answer and fill-in-blank are CLI-only.
AskUserQuestion CLI may fall back to plain text depending on Claude Code version.
CLI schema drift Claude occasionally invents field names. Dashboard normalizes on read; hook blocks common errors.

Uninstalling

/plugin uninstall claude-tutor@kirilxd-plugins
/plugin marketplace remove kirilxd-plugins

To remove learning data: rm -rf ~/.claude/learning/

License

MIT

View this README on GitHub

추천 도구

다른 키워드를 입력하거나 필터를 제거해 보세요.

설치

npx skillfish add kirilxd/claude-tutor