convez.ai
PluginProdutividadeIntermediário
yarikleto

Claude Teacher Plugin

yarikleto/claude-teacher-plugin

Tutor IA atencioso que ensina sem dar respostas diretas, rastreia progresso

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin de tutoria adaptativa para Claude Code que ensina por meio do método socrático, rastreia progresso entre sessões e personaliza o aprendizado conforme seu nível e estilo. Funciona para qualquer disciplina — programação, matemática, finanças, história — com quizzes de repetição espaçada e detecção de erros de raciocínio.

Instalação

$npx convez-ai yarikleto/claude-teacher-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
15
Forks
3
Acompanhando
0
Saúde
28%
Último commit
há 5 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Aprendizado estruturado de programação e algoritmos
  • Preparação para provas e exames com quizzes personalizados
  • Tutoria contínua em qualquer disciplina com persistência de dados

Veredito

Plugin robusto que reimagina tutoria IA com foco em aprendizado profundo via método socrático e rastreamento persistente. Bem pensado em UX (onboarding automático, perfil adaptativo) e versatilidade cross-disciplinar — vale a investigação mesmo fora do escopo estritamente técnico.

README

A tradução para o português deste README ainda está na fila.


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 remembers everything. 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

# 1. Add the marketplace (one time)
claude plugins marketplace add https://github.com/yarikleto/claude-teacher-plugin

# 2. Install in your project
cd your-project
claude plugins install claude-teacher --scope project

That's it. Start a new Claude Code session — the plugin detects you're a new student and runs onboarding automatically. After that, just start learning.

Run /init-edu manually at any time to set up a new project or re-do onboarding.


What Happens After Setup

Teaching mode is always on. No commands needed. Just talk to Claude:

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

The tutor will:

  1. Research the topic via web search — never hallucinates, always provides sources
  2. Explain using analogies from your interests
  3. Adapt tone and vocabulary to your age (a 14-year-old and a 35-year-old get very different explanations)
  4. Teach in the style of your ideal teacher — strict professor, friendly mentor, no-nonsense coach — whatever you described during setup
  5. Quiz you after 2-3 concepts
  6. Ask "explain your thinking" to catch right-answer-wrong-reasoning
  7. Track everything in your personal knowledge DB
  8. Auto-save progress when you leave

Skills

/init-edu — Onboarding & Project Setup

Student profile (first time only) — 9 questions, one at a time:

  • Name and age (age calibrates tone and vocabulary automatically)
  • Current level and what you already know (to build on it)
  • How you learn best and what frustrates you
  • Goals with deadlines
  • Interests (used for analogies)
  • Your ideal teacher — describe the vibe: strict, funny, patient, direct, etc.

Project setup:

  • CLAUDE.md — teacher persona + student profile + teaching rules adapted to your learning type
  • .claude/settings.json — output style + hooks + defaultView: chat (hides tool noise)
  • docs/ — directory for saved explanations
  • Global education DB at ~/.local/share/claude-education/

/quiz-me [topic] — Adaptive Quizzes

> /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

/research <task> — Study Plan Generator

> /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.

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

> /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.

/demo [concept] — Animated Interactive Visualizations

> /demo TCP 3-way handshake

Saved: docs/tcp-3-way-handshake.html
Open in any browser — no server needed.

Generates a self-contained .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, works offline. 6 styles: protocol flows, algorithm traces, state machines, data flow pipelines, memory/stack visualizations, network topology.

/excalidraw [concept] — Interactive Excalidraw Diagrams

> /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.

/ascii [concept] — ASCII Diagrams

> /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.

/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.

/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.

/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.

Real quotes fetched live from APIs (ZenQuotes, Forismatic). 18 verified fallback quotes from Feynman, Curie, Dijkstra, Turing, Knuth, Polya. Auto-triggers when the tutor detects frustration or repeated failures.

/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.

/save-progress — Mid-Session Checkpoint

Quick save without ending the session. Use anytime you want a safety checkpoint.

/flashcards [topic] — Anki-Style Flashcard Generation

> /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 /flashcards without a topic to generate cards for all studied topics.

/roadmap <goal> — Visual Learning Path

> /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 /research. Re-run after learning new topics to see your progress visually.

/reset-edu — Delete All Data

Wipes everything: profile, quiz history, topic progress, session logs, saved docs. Asks for YES confirmation before deleting. Run /init-edu afterward to start fresh.


Hooks

5 hooks that automate the teaching workflow. Configured globally — work across all your learning projects.

HookTriggerWhat it does
session-start-load-dbSession startLoads profile, calculates overdue topics with exact days, flags weak topics — tells Claude to quiz before teaching new material
inject-teach-contextEvery messageInjects teaching-mode rules into every prompt — keeps Claude in tutor mode, enforces research-before-explaining and auto-save
stop-save-progressSession endBlocks session close and reminds Claude to save progress to the DB (only fires in learning projects)
post-code-reviewAfter code editReminds tutor to ask pedagogical questions instead of just moving on
post-quiz-motivateAfter code failsSuggests encouragement when your code throws errors

Learning Types

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

TypeExampleClaude focuses on
ProjectFTP server, budget tracker, gameSkeletons, incremental building, hands-on review
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 all projects in ~/.local/share/claude-education/:

~/.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

Spaced Repetition

At every session start, the hook scans all topic files, calculates exact days overdue, and tells Claude what to review first:

OVERDUE (quiz these first):
  - Compound interest (3d overdue, working, interval: 4d)
  - TCP basics (1d overdue, surface, interval: 1d)

WEAK (re-explain before new material):
  - OSI model (weak, surface)

Review intervals double on success, reset to 1 day on failure:

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

Day 1:
  /init-edu                      Onboarding — name, age, background, ideal teacher, topic
  "explain compound interest"    Researches, explains with your analogies, saves to docs/
  /ascii growth over time         ASCII chart + sources
  /demo TCP handshake               Animated step-by-step in browser
  /challenge                     "Allocate $500/month. Justify your split."
  /summary                       Recap + spaced repetition schedule

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

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

Re-initialization

Run /init-edu again in any project:

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.)
  c) Full reset — start fresh (wipes profile, keeps quiz history)
  d) Complete reset — wipe everything (profile + all progress)

Updating

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

Use the same --scope you used during install. Restart the session after updating.

Uninstall

claude plugins uninstall claude-teacher

Ver o original no GitHub

Bom para

Relacionados