claude-code-tutor

claude-code-tutor

A Claude Code plugin that tutors workshop attendees on how to use and improve their Claude Code workflow. Content is sourced from the Claude Code Wiki and Anki flashcard decks via AnkiConnect.

Prerequisites

• Claude Code CLI
• Anki with AnkiConnect add-on (for quiz mode)
• Study guide flashcard decks imported into Anki (see below)

Setting up Anki flashcard decks

The tutor's quiz mode pulls questions from Anki flashcard decks built from the Claude Code Wiki. To set them up:

1. Clone the Claude Code Wiki Study Guide
2. Follow the Install Anki, Import the Decks, and Card Types sections in that repo's README
3. Install the AnkiConnect add-on and keep Anki running when using quiz mode

Installation

claude plugin marketplace add malston/claude-code-tutor
claude plugin install claude-code-tutor@claude-code-tutor-dev

Setup

Run the setup command to configure your preferences:

/claude-code-tutor:setup

This creates ~/.claude-code-tutor/progress.json with your settings:

• Progression mode: teach-back (explain concepts back for evaluation) or self-assessed
• Content source: remote (GitHub Pages), local (Hugo dev server), or both
• Hooks: opt-in session status display and progress auto-save

Usage

Ask questions (auto-invokes)

Just ask any Claude Code question and the tutor skill activates automatically:

"How does prompt caching work?" "What's the best way to set up hooks?"

Structured learning

/claude-code-tutor:tutor              # Resume where you left off
/claude-code-tutor:tutor internals    # Start guided discovery for a specific topic
/claude-code-tutor:tutor quiz         # Quiz on your current topic
/claude-code-tutor:tutor quiz guides  # Quiz on a specific topic
/claude-code-tutor:tutor progress     # See your progress across all topics

Progressive unlocking

Topics unlock as you complete prerequisites:

Level 1: Internals (start here)
Level 2: Guides (requires Internals)
Level 3: Extending (requires Internals)
Level 4: Product (requires Guides)
Level 5: Enterprise Rollout (requires Extending)
Level 6: Training Paths (requires Product + Enterprise Rollout)

Locked topics use soft gates -- you can jump ahead, but the tutor will offer to cover foundations first.

Components

Type	Name	Purpose
Skill	tutor	Auto-invokes on Claude Code questions, routes to interaction modes
Agent	content-retriever	Fetches wiki content and AnkiConnect flashcards
Agent	assessment-evaluator	Scores teach-back explanations and quiz answers
Command	/claude-code-tutor:tutor	Structured learning sessions
Command	/claude-code-tutor:setup	First-run configuration
Hook	SessionStart	Session status display (opt-in)
Hook	PostToolUse	Progress auto-save (opt-in)

License

MIT