Back to search
kirilxd-plugins
MarketplaceWorks with Claude CodeGitHub
Turn Claude Code into your personal tutor — personalized learning plans, adaptive quizzes, SM-2 spaced repetition, and a web dashboard. Works with any topic.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked yesterday
Badge for your README
Markdown
[](/listings/kirilxd--claude-tutor)HTML
<a href="/listings/kirilxd--claude-tutor"><img src="/api/listings/kirilxd--claude-tutor/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 14 lines
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "kirilxd-plugins",
- "owner": {
- "name": "kirilxd"
- },
- "plugins": [
- {
- "name": "claude-tutor",
- "source": {"source": "github", "repo": "kirilxd/claude-tutor"},
- "description": "Interactive learning companion — plans, quizzes, spaced repetition, web dashboard"
- }
- ]
- }
README.md · README · 180 lines
- <p align="center">
- <img src="assets/logo.png" alt="claude-tutor logo" width="180">
- </p>
- <h1 align="center">claude-tutor</h1>
- <p align="center">Turn Claude Code into your personal tutor — with spaced repetition.</p>
- <p align="center">
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
- <a href="https://github.com/kirilxd/claude-tutor"><img src="https://img.shields.io/badge/Claude_Code-2.0+-7C3AED.svg" alt="Claude Code 2.0+"></a>
- <a href="https://github.com/kirilxd/claude-tutor"><img src="https://img.shields.io/badge/node-18+-339933.svg?logo=node.js&logoColor=white" alt="Node.js 18+"></a>
- </p>
- <br>
- <p align="center">
- <img src="assets/screenshot-overview.png" alt="Dashboard overview" width="720">
- </p>
- <br>
- ## 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.
- <details>
- <summary>Learning plan</summary>
- <br>
- <img src="assets/screenshot-plan.png" alt="Learning plan view" width="720">
- </details>
- <details>
- <summary>Progress tracking</summary>
- <br>
- <img src="assets/screenshot-progress.png" alt="Progress tracking view" width="720">
- </details>
- <details>
- <summary>Review calendar</summary>
- <br>
- <img src="assets/screenshot-calendar.png" alt="Review calendar view" width="720">
- </details>
- ## Commands
- | Command | Description | Example |
- |---|---|---|
- | `/learn <topic>` | 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 <topic>` | 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/
- │ └── <topic>-<date>.json # learning plans
- └── progress/
- └── <topic>.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
- ```bash
- 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.