claudeers.
// Claude Plugins

claude-teacher-plugin

Claude Code plugin — the most attentive AI tutor. Teaches, tracks knowledge, quizzes, and adapts to your level.

Slowing down
86/100
last commit 2 months ago
last release none
releases 0
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up claude-teacher-plugin (claude-plugin project) into my current project.
Found on https://claudeers.com/claude-teacher-plugin
Repo: https://github.com/yarikleto/claude-teacher-plugin
Homepage/docs: —
Detected install method: claude-plugin → /plugin install claude-teacher-plugin@yarikleto/claude-teacher-plugin
Category: plugins. Platforms: api, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
slowing; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add yarikleto/claude-teacher-plugin
/plugin install claude-teacher-plugin@yarikleto/claude-teacher-plugin
// or clone
git clone https://github.com/yarikleto/claude-teacher-plugin

// compatibility

Platformsapi, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageHTML

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Claude Teacher — The AI tutor plugin for Claude Code

The most attentive AI tutor for Claude Code
Teaches any subject by guiding, not giving answers. Tracks your knowledge across sessions.
Quizzes with spaced repetition. Catches wrong reasoning. Adapts to you.


Why Claude Teacher?

Most AI tools give you the answer and move on. Claude Teacher makes you earn it — through the Socratic method, targeted quizzes, and challenges designed around your specific misunderstandings.

Works for any subject — CS, math, finance, psychology, history, exam prep, side projects. Not just programming.

It keeps a persistent learning record. Your progress, misconceptions, and learning style persist across sessions and projects. Come back next week — the tutor picks up exactly where you left off, quizzes you on what's overdue, and skips what you already know.


Quick Start

Open Claude Code in the folder where you want to learn. Paste these commands into the Claude Code conversation, one at a time:

  1. Add Claude Teacher to the available plugins:

    /plugin marketplace add yarikleto/claude-teacher-plugin
    
  2. Install it. When Claude asks where to install, choose Project:

    /plugin install claude-teacher@claude-teacher-marketplace
    
  3. Start your learning setup:

    /claude-teacher:init-edu
    

Claude asks what you want to learn and whether you've tried it before, then starts the first lesson. If you've already answered, it skips those questions. You can add personal preferences later.

If the setup command isn't visible after installation, enter /reload-plugins and try again. These steps use Claude Code's built-in plugin installer.

Teaching instructions are added only to folders where you run /claude-teacher:init-edu. Your other projects keep their usual behavior.

Requirements

  • Claude Code installed and signed in, with permission to read and write your learning files. This release's plugin integration is validated with 2.1.260.
  • Network access for source research and the demo's CDN libraries. Missing research tools are disclosed; teaching can continue from verified material.

Extra hook reminders use existing local tools when available. They are not a setup task for the student; technical details are in Hooks. The plugin does not install helper software.


What Happens After Setup

Teaching mode is active in initialized projects and respects your pace and requests to pause. Just talk to Claude:

"Explain compound interest" or "Teach me about TCP sockets" or "Help me understand recursion"

The tutor will:

  1. Research new or uncertain claims using authoritative sources and provide links
  2. Explain using analogies from your interests
  3. Adapt tone and vocabulary to your demonstrated understanding and preferences; age is optional
  4. Start with clear, friendly explanations and adapt to the teacher style you prefer
  5. Quiz you after 2-3 concepts
  6. Ask "explain your thinking" to catch right-answer-wrong-reasoning
  7. Record new learning evidence in your local progress files
  8. Save new evidence during the lesson and give a recap when you say you are finished

These are instructions Claude follows using its tools, with or without hook reminders. A save is complete only after the files are written successfully; Claude should tell you if saving fails. You can also ask “show my progress” or use the explicit skill commands below.


Skills

/claude-teacher:init-edu — Onboarding & Project Setup

Full onboarding in one command

Two starting questions, only if you haven't already answered:

  • What would you like to learn or build?
  • Have you tried it before, or are you starting from scratch?

“Not sure” is fine. Claude starts gently and adjusts from your answers. Your name, age, interests, goals, and preferred teacher style are optional; share them when useful rather than completing a long questionnaire first.

Setup uses Claude Code's available tools. There is no required dependency diagnostic or technical mode to choose. The project instructions tell Claude to load earlier progress, suggest relevant reviews, and save new learning even when hooks are unavailable.

Project setup:

  • CLAUDE.md — a managed teaching block, preserving existing project instructions; the personal profile stays in the global DB
  • .claude/claude-teacher.json — marks the folder as a learning project, which is what activates the hooks
  • .claude/settings.json — adds Explanatory output style if none is already selected, preserving other settings and hooks
  • docs/ — directory for saved explanations
  • Global education DB at ~/.local/share/claude-education/

/claude-teacher:quiz-me [topic] — Adaptive Quizzes

> /claude-teacher:quiz-me personal finance

Q1 (medium): What is the difference between a Roth IRA and a Traditional IRA?

  a) Roth is pre-tax, Traditional is post-tax
  b) Roth is post-tax, Traditional is pre-tax
  c) Both are pre-tax but differ in withdrawal rules
  d) They are the same with different contribution limits
FeatureHow it works
Misconception-firstReads your unresolved misconceptions, crafts questions to test them
Spaced repetitionPicks topics due for review based on scheduling algorithm
Adaptive difficultyIncreases after 2+ correct, decreases after 2+ wrong
"Explain your thinking"~30% of correct answers get a "Why?" follow-up
Full recordingEvery question, answer, and score saved to the grade book
Auto-promotionScore ≥80% → promotes toward Solid. <50% → demotes to Weak

/claude-teacher:research <task> — Study Plan Generator

> /claude-teacher:research build an FTP server in C

Saved: docs/study-plan-ftp-server.md

Decomposes any task or project into a structured study plan with phases (prerequisites → core skills → nice-to-have). For each topic: explains why it's needed, links to real resources (official docs, tutorials, articles, videos), includes self-check questions, and estimates study time. Cross-references your existing knowledge — skips what you already know. Saves as a markdown checklist you can follow at your own pace.

/claude-teacher:compare <A> vs <B> — Side-by-Side Comparisons

> /claude-teacher:compare REST vs GraphQL

── Compare: REST vs GraphQL ──────────────────

## What they are
**REST:** An architectural style using standard HTTP methods on resource URLs.
**GraphQL:** A query language that lets clients request exactly the data they need.

## Side-by-side comparison
| Feature        | REST               | GraphQL             |
|----------------|--------------------|---------------------|
| Data fetching  | Fixed endpoints    | Flexible queries    |
| Over-fetching  | Common             | Avoided by design   |
| Caching        | HTTP caching       | Needs custom layer  |
| Learning curve | Lower              | Higher              |
| ...            | ...                | ...                 |

## When to use which
Choose REST when: simple CRUD, public APIs, caching matters
Choose GraphQL when: complex nested data, mobile clients, multiple consumers

Researches both concepts via WebSearch before comparing. Includes a comparison table, concrete "when to use which" scenarios, common misconceptions about the differences, and a key takeaway. Adapts to student level. Saves to docs.

/claude-teacher:demo [concept] — Animated Interactive Visualizations

> /claude-teacher:demo TCP 3-way handshake

Saved: docs/tcp-3-way-handshake.html
Open in any browser.

Generates a single .html file with step-by-step animated diagrams. Play/pause, prev/next controls, keyboard shortcuts (arrows + space), speed control, and an explanation panel that updates with each step. Dark theme, responsive. Styling and the UI layer load from a CDN, so first open needs a network connection. 6 styles: protocol flows, algorithm traces, state machines, data flow pipelines, memory/stack visualizations, network topology.

/claude-teacher:excalidraw [concept] — Interactive Excalidraw Diagrams

> /claude-teacher:excalidraw TCP 3-way handshake

Saved: docs/tcp-3-way-handshake.excalidraw

Open in VS Code (Excalidraw extension) or at excalidraw.com

Generates editable .excalidraw JSON diagrams with color-coded elements, proper arrow bindings, and semantic layout. 5 styles: sequence diagrams, flowcharts, architecture layers, data structures, side-by-side comparisons. Researches sources before drawing. Diagrams are fully interactive — move, edit, annotate, export.

/claude-teacher:ascii [concept] — ASCII Diagrams

> /claude-teacher:ascii compound interest over time

  $1000 @ 10%/year

  Year 0  ████  $1,000
  Year 5  ████████  $1,611
  Year 10 ████████████  $2,594
  Year 20 ████████████████████  $6,727
               └── interest on interest, not just principal

6 styles: sequence diagrams, flowcharts, comparisons, architecture layers, charts, tree hierarchies. Researches official sources before drawing. Auto-saves to your reference library.

/claude-teacher:progress — Knowledge Dashboard

══════════════════════════════════════════════════
  KNOWLEDGE DASHBOARD
══════════════════════════════════════════════════

  Overall: 10 topics · 5 quizzes · avg 74%

  Solid (3)     ██████░░░░░░░░░░░░░░  30%
  Learned (5)   ██████████░░░░░░░░░░  50%
  Weak (2)      ████░░░░░░░░░░░░░░░░  20%

  OVERDUE FOR REVIEW
  · compound-interest — 3d overdue (working)
  · tcp-basics — due today (surface)

  UNRESOLVED MISCONCEPTIONS
  · tcp-congestion: "confused slow start with congestion avoidance"

  GOALS
  · Pass OS exam — 88 days away — 3/10 topics solid
══════════════════════════════════════════════════

Shows overdue topics with exact days, depth per topic, misconceptions, goal progress with deadline countdowns.

/claude-teacher:challenge — Mini-Tasks

Hands-on exercises designed around your weak spots and learning type:

Learning typeExample
Project"Write a function that creates a TCP socket, binds to port 0, and prints the assigned port"
Subject / field"You have $500/month to invest. Allocate it between index funds, bonds, and cash. Justify your split."
Exam prep"Trace quicksort on [3, 6, 1, 8, 2]. Show each partition step."

Targets surface → working depth promotion. Designs challenges around unresolved misconceptions.

/claude-teacher:motivate — Motivation Boost

╔══════════════════════════════════════════════════╗
║                                                  ║
║  "If you can't solve a problem, then there is    ║
║   an easier problem you can solve: find it."     ║
║                                                  ║
║                          — George Polya           ║
║                                                  ║
╚══════════════════════════════════════════════════╝

You've conquered 3 topics this week. This one's no different
— just needs a different angle.

Brief encouragement based on your actual progress. May include a sourced quote from ZenQuotes; uses original encouragement when a quote cannot be verified or the network is unavailable. Auto-triggers when the tutor detects frustration or repeated failures.

/claude-teacher:summary — Session Recap

Full DB flush at session end. Shows what was learned, quiz results, depth changes, resolved misconceptions, spaced repetition schedule, and a prioritized plan for next time.

/claude-teacher:save-progress — Mid-Session Checkpoint

Saves new learning evidence without ending the session, preserving existing history and skipping duplicate events. Use anytime you want a checkpoint, including when automatic hooks are unavailable.

/claude-teacher:flashcards [topic] — Anki-Style Flashcard Generation

> /claude-teacher:flashcards tcp-basics

── Flashcards Generated ──────────────────
  Topic: TCP Basics
  Cards: 8 (3 easy / 3 medium / 2 hard)
  Misconception cards: 1
  Card types: definition, what-happens-if, compare/contrast, fill-in-the-blank

  Saved to:
    docs/flashcards-tcp-basics.md
    docs/flashcards-tcp-basics.csv
──────────────────────────────────────────

Generates flashcards from your studied topics in two formats: Markdown (for reading) and Anki-compatible CSV (semicolon-separated, importable directly). Card types: definitions, concept application, "what happens if...", compare/contrast, fill-in-the-blank. Prioritizes weak topics, unresolved misconceptions, and topics due for review. Run /claude-teacher:flashcards without a topic to generate cards for all studied topics.

/claude-teacher:roadmap <goal> — Visual Learning Path

> /claude-teacher:roadmap backend development

── Roadmap Generated ────────────────────
  Goal: Backend Development
  Topics: 14 (3 solid / 2 learned / 1 weak / 8 new)
  Milestones: 3
  Current position: HTTP fundamentals

  Saved to:
    docs/roadmap-backend-development.excalidraw
    docs/roadmap-backend-development.md
──────────────────────────────────────────

Generates an interactive .excalidraw diagram showing your full learning path — topic nodes color-coded by status (green=solid, blue=learned, red=weak, gray=new), prerequisite arrows, milestone markers, and a "YOU ARE HERE" indicator. Also saves a markdown companion with the same info as a text checklist. Visual companion to /claude-teacher:research. Re-run after learning new topics to see your progress visually.

/claude-teacher:reset-edu — Delete All Data

Deletes the resolved global education DB (including global saved explanations) after showing its path and asking for YES. This affects every project using that DB. Project files, local docs, and teaching settings remain. Run /claude-teacher:init-edu afterward to start fresh.


Hooks

5 hooks provide extra reminders and a prepared review summary alongside the project teaching instructions. The plugin registers them itself, so they survive plugin updates — no per-project wiring. The lesson instructions and skills remain usable when these reminders are unavailable.

Each hook explicitly checks runtime availability, then validates the event and checks .claude/claude-teacher.json; legacy projects with memory/knowledge_gaps.md also activate. Set enabled: false in the marker to pause hook reminders. Invalid markers, malformed hook payloads, and subagent activity are ignored.

Hooks require Bash and use jq 1.6+, falling back to installed Python 3.8+ with its standard library when jq is missing or unusable. Both paths apply the same project and loop guards. If neither JSON tool works, the scripts exit quietly without touching student data; Claude is still instructed to handle the lesson and checkpoint new evidence through the skills.

The hook scripts target macOS, Linux, and WSL. Native Windows without Bash has not been validated; the registered shell hooks cannot run there. The teaching instructions themselves do not require jq or Python. Setup does not ask learners to install tools to enable extra reminders.

For requested troubleshooting, check-runtime.sh reports whether the hook helpers are usable. A successful check confirms tool availability; it does not prove hooks loaded or progress was saved. It is not part of normal onboarding.

HookTriggerWhat it does
session-start-load-dbSession start/resumeLoads profile and up to five topics per review category, using calendar dates; excludes untaught topics
inject-teach-contextEvery messageReminds Claude to tutor at the student's pace, verify uncertain claims, and save new learning evidence
stop-save-progressEnd of each responseRequests one checkpoint of unsaved learning evidence; checks the loop guard before continuing
post-code-reviewAfter Claude uses Edit/Write on sourceSuggests a relevant reasoning question for exercises; does not observe edits in your editor
post-quiz-motivateAfter Bash tool failureSuggests guidance for exercise failures, excluding cancellations and simple housekeeping

Readable code and data access

The hooks are plain Bash, jq, and Python source with descriptive names, small functions, and readable teaching instructions. Loading a helper only defines functions; runtime checks and exit decisions are explicit in the event scripts. JSON input is parsed as data, never evaluated as code. Expected input failures are handled quietly; Python programming errors remain visible for diagnosis.

The hook code reads the project marker and relevant education records, then returns context to Claude. It makes no network requests, installs no software, and does not write student files itself. The session summary includes student and topic labels. The Stop hook asks Claude to save through the save-progress skill; the save still depends on Claude completing that action and having permission.

For a manual review, start with the hook code guide and event registrations. The guide maps every event to its script and documents file access, outputs, runtime selection, and failure handling.


Learning Types

/claude-teacher:init-edu adapts to what you're studying:

TypeExampleClaude focuses on
ProjectFTP server, budget tracker, gameIncremental building, hands-on review — you write every line
Subject / fieldFinance, psychology, math, CSConcepts, real-world scenarios, comparisons, "why it matters"
Exam prepOS exam, job interview, certificationKey concepts, practice questions, weak spots, timed drills

How It Tracks Your Knowledge

Global Education DB

Your progress persists across learning projects in ~/.local/share/claude-education/. Set CLAUDE_TEACHER_DB to an absolute path before launching Claude Code to use a different database; hooks and skills use the same location:

~/.local/share/claude-education/
├── student.json       Profile — name, age, persona, interests, goals, learning style
├── dashboard.json     All topic statuses and stats at a glance
├── topics/            One file per topic — status, depth, misconceptions, review schedule
├── quizzes/           Every quiz ever taken — the grade book
├── sessions/          Session logs — what happened each day
└── docs/              Saved explanations — reusable across projects

Quiz records use a unique ID per attempt, so repeated quizzes on the same topic/day remain separate. Saves merge existing history and skip duplicate events. Writes are designed for one active writer per DB; concurrent sessions require care when merging. A checkpoint can request saving, but cannot guarantee it after a permission denial, crash, forced exit, or API failure.

Spaced Repetition

When automatic hooks are available, the session-start hook scans topic records, skips untaught or invalid records, and shows up to five topics per review category. It orders overdue topics by days overdue and uses calendar dates to avoid daylight-saving errors. An example summary:

OVERDUE FOR REVIEW (1 total; showing up to 5):
- Compound interest [learned] — 3d overdue

DUE FOR REVIEW TODAY (1 total; showing up to 5):
- TCP basics [solid]

WEAK TOPICS (1 total; showing up to 5):
- OSI model [weak]

Reviews are suggestions that respect the student's current request and pace. Without the prepared hook summary, the lesson instructions ask Claude to read the relevant records itself. Ask “show my progress” or use /claude-teacher:progress for the full queue.

Completed assessments update intervals once: ≥80% doubles the interval, <50% resets it to one day, and intermediate scores retain it. Diagrams, reading, repeated saves, and unfinished quizzes do not advance review dates:

Day 1 ──► Day 2 ──► Day 4 ──► Day 8 ──► Day 16 ──► ...
         (pass)    (pass)    (pass)    (pass)

Day 1 ──► Day 2 ──► FAIL ──► Day 1 (reset, demoted to Weak)

Topic Depth

DepthMeaningHow to advance
surfaceHeard the explanationUse it correctly in a quiz or challenge
workingUsed it correctlyExplain your reasoning, handle edge cases
deepCan teach it to othersConnect to other topics, no misconceptions

Misconception Tracking

When you get something wrong, the tutor records what you said and why it's wrong — not just "incorrect." Future quizzes and challenges specifically target your unresolved misconceptions.

Age-Based Tone

The tutor calibrates vocabulary and examples automatically:

AgeStyle
≤12Simple words, playful analogies, no jargon
13–17Casual and clear, school/hobby examples
18–25Adult tone, university/career examples
26+Peer tone, real-world professional examples

Example Workflow

The commands below are optional shortcuts. You can also ask for a quiz, request your progress, or say you are finished in ordinary conversation. Where available, hooks supply extra reminders; the project instructions cover the same lesson routine without them.

Day 1:
  /claude-teacher:init-edu                      Pick a topic and starting level; personalize later
  "explain compound interest"    Researches, explains with your analogies, saves to docs/
  /claude-teacher:ascii growth over time         ASCII chart + sources
  /claude-teacher:demo TCP handshake               Animated step-by-step in browser
  /claude-teacher:challenge                     "Allocate $500/month. Justify your split."
  /claude-teacher:summary                       Recap + spaced repetition schedule

Day 2:
  (hook at session start)        Suggests reviewing compound interest, 1d overdue
  /claude-teacher:quiz-me compound interest     Targets your misconceptions first
  /claude-teacher:compare REST vs GraphQL       Side-by-side comparison with scenarios
  (continue learning)            New concepts with periodic quizzes
  /claude-teacher:save-progress                 Mid-session checkpoint
  /claude-teacher:progress                      Dashboard: overdue topics, depth levels, goals

Day 3:
  (hook: 2 topics overdue)       Quick review before new material
  /claude-teacher:quiz-me finance basics        9/10! Promoted to Solid
  (stuck on something)           Auto-triggers /claude-teacher:motivate
  /claude-teacher:summary                       Schedule set, next session plan ready

Re-initialization

Run /claude-teacher:init-edu again to update preferences or set up another learning folder. It preserves your learning history and refreshes the managed teaching instructions. Earlier plugin-owned “manual mode” notes are replaced with the lesson routine; real unresolved file-access problems are still reported.

For an existing profile, it offers:

Welcome back! What would you like to do?

  a) Set up this project for learning (keep my profile)
  b) Update my profile (change name, interests, goals, persona, etc.)
  For a full reset, run /claude-teacher:reset-edu separately.

Updating

claude plugin update claude-teacher@claude-teacher-marketplace --scope project

Use the same --scope you used during install. Run /reload-plugins to load updated components, or restart the session.

Upgrading from 1.8.0 or earlier: those versions wrote a hooks block into each project's .claude/settings.json containing absolute paths into the plugin cache. Those paths point at the previous version's directory and no longer resolve. Run /claude-teacher:init-edu in each learning project. It removes only handlers clearly owned by this plugin, preserves unrelated hooks/settings, and adds the project marker. Do not delete the whole hooks block.

Development and validation

python3 -m unittest discover -s tests -v
node --test tests/demo.test.cjs
claude plugin validate .claude-plugin/plugin.json --strict
claude plugin validate . --strict

Validate both manifests: . selects the marketplace. See .claude/CLAUDE.md for development rules and CHANGELOG.md for changes.

The hook suite tests jq and Python separately, including missing or broken tools, project opt-out, malformed data, checkpoint loop protection, import isolation, and a 500-topic review queue. To exercise both backends, install jq and Python in the development environment; jq-specific tests are skipped if jq is absent. Node.js is used for the demo tests, not by the hooks.

The integration follows the official plugin reference, hook reference, and skill authoring docs. The flashcard format follows Anki's text-import headers.

Uninstall

claude plugin uninstall claude-teacher

Stop copying answers. Start actually learning.
MIT License

// faq

What is claude-teacher-plugin?

Claude Code plugin — the most attentive AI tutor. Teaches, tracks knowledge, quizzes, and adapts to your level.. It is open-source on GitHub.

Is claude-teacher-plugin free to use?

claude-teacher-plugin is open-source under the MIT license, so it is free to use.

What category does claude-teacher-plugin belong to?

claude-teacher-plugin is listed under plugins in the Claudeers registry of Claude-compatible tools.

25 views
★ 15 stars
unclaimed
updated about 1 month ago

// embed badge

claude-teacher-plugin on Claudeers
[![Claudeers](https://claudeers.com/api/badge/claude-teacher-plugin.svg)](https://claudeers.com/claude-teacher-plugin)

// retro hit counter

claude-teacher-plugin hit counter
[![Hits](https://claudeers.com/api/counter/claude-teacher-plugin.svg)](https://claudeers.com/claude-teacher-plugin)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how claude-teacher-plugin connects across the ecosystem