tutor-skill
Two Claude Code skills that turn any knowledge source into an Obsidian StudyVault and then quiz you on it — closing the loop from content to comprehension.
How It Works
Documents / Code Obsidian Quiz Session
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ PDF, MD, HTML, │ /tutor │ StudyVault/ │ /tutor │ 4 questions per │
│ EPUB, source │──setup──▶ │ structured │────────▶ │ round, graded, │
│ code projects │ │ interlinked │ │ concept tracking │
└──────────────────┘ │ notes + MOC │ └────────┬─────────┘
└──────────────────┘ │
▲ │
└─────── progress updates ────┘
Skills Overview
| Skill | Command | Purpose | Input | Output |
|-------|---------|---------|-------|--------|
| tutor-setup | /tutor-setup | Generate a StudyVault | Documents or source code | Obsidian vault with notes, dashboards, practice questions |
| tutor | /tutor | Interactive quiz tutor | An existing StudyVault | Quiz sessions with concept-level progress tracking |
Quick Start
One-line install (recommended)
npx skills add RoundTable02/tutor-skills
Requires npx skills — works with Claude Code, Cursor, Windsurf, and more.
Manual install
git clone https://github.com/RoundTable02/tutor-skills.git
cd tutor-skills
./install.sh
Step 1: Generate a StudyVault
cd ~/study-materials/ # or any source code project
claude
> /tutor-setup
Step 2: Start Quizzing
claude
> /tutor
tutor-setup
Transforms knowledge sources into a structured Obsidian StudyVault. Mode is auto-detected:
| Marker Found | Mode |
|---|---|
| package.json, pom.xml, build.gradle, Cargo.toml, go.mod, etc. | Codebase Mode |
| No project markers | Document Mode |
Document Mode
Turns PDFs, text files, web pages, and other sources into comprehensive study notes.
- Auto-scans working directory for source files (PDF, TXT, MD, HTML, EPUB)
- Extracts and analyzes content with verified source mapping
- Generates concept notes with comparison tables, ASCII diagrams, and exam patterns
- Creates practice questions with hidden answers (active recall via fold callouts)
- Builds a dashboard with Map of Content (MOC), Quick Reference, and Exam Traps
- Full interlinking with
[[wiki-links]]across all notes
Phases
| Phase | Name | Description | |-------|------|-------------| | D1 | Source Discovery | Scan, extract, and verify source content mapping | | D2 | Content Analysis | Build topic hierarchy and dependency map | | D3 | Tag Standard | Define English kebab-case tag registry | | D4 | Vault Structure | Create numbered folders per topic | | D5 | Dashboard | MOC, Quick Reference, Exam Traps | | D6 | Concept Notes | Structured notes with tables, diagrams, callouts | | D7 | Practice Questions | Active recall with fold callouts (8+ per topic) | | D8 | Interlinking | Cross-reference all notes with wiki-links | | D9 | Self-Review | Verify against quality checklist |
Generated structure
StudyVault/
00-Dashboard/ # MOC + Quick Reference + Exam Traps
01-<Topic1>/ # Concept notes + practice questions
02-<Topic2>/
...
Codebase Mode
Generates a new-developer onboarding vault from a source code project.
- Auto-detects tech stack, architecture patterns, and module boundaries
- Traces request flows and data flows end-to-end
- Creates per-module notes with key files, public interfaces, and dependency maps
- Generates onboarding exercises (code reading, configuration, debugging, extension)
- Builds a dashboard with architecture overview, module map, API surface, and getting started guide
Phases
| Phase | Name | Description |
|-------|------|-------------|
| C1 | Project Exploration | Scan files, detect tech stack, map layout |
| C2 | Architecture Analysis | Identify patterns, trace flows, map modules |
| C3 | Tag Standard | Define #arch-*, #module-*, #pattern-* registry |
| C4 | Vault Structure | Create dashboard + per-module folders |
| C5 | Dashboard | MOC with module map, API surface, getting started |
| C6 | Module Notes | Purpose, key files, interface, flow, dependencies |
| C7 | Exercises | Code reading, config, debugging, extension tasks |
| C8 | Interlinking | Cross-link all modules and exercises |
| C9 | Self-Review | Verify against quality checklist |
Generated structure
StudyVault/
00-Dashboard/ # MOC + Quick Reference + Getting Started
01-Architecture/ # System overview, request flow, data flow
02-<Module1>/ # Per-module notes
03-<Module2>/
...
NN-DevOps/ # Build, deploy, CI/CD
NN+1-Exercises/ # Onboarding exercises
tutor
Interactive quiz tutor that tracks what you know and don't know at the concept level. Works with any StudyVault generated by tutor-setup.
Session Types
| Type | When Available | Focus | |------|----------------|-------| | Diagnostic | Unmeasured areas (⬜) exist | Broad assessment of new areas | | Drill weak areas | Weak areas (🟥/🟨) exist | Targeted practice on struggles | | Choose a section | Always | Study any area on demand | | Hard-mode review | All areas 🟩/🟦 | Challenge mastered material |
Quiz Flow
- Detects your StudyVault and reads the learning dashboard
- Presents session options based on your current proficiency
- Delivers 4 questions per round (4 options each, zero hints)
- Grades answers and explains mistakes
- Updates concept files and dashboard automatically
Progress Tracking
Proficiency is tracked per area with emoji badges:
| Badge | Level | Rate | |-------|-------|------| | 🟥 | Weak | 0–39% | | 🟨 | Fair | 40–69% | | 🟩 | Good | 70–89% | | 🟦 | Mastered | 90–100% | | ⬜ | Unmeasured | No data |
Concept-level tracking stores attempts, correct count, last tested date, and error notes for wrong answers — so drill sessions rephrase missed concepts in new contexts.
The Learning Cycle
┌────────────────────────────┐
│ /tutor-setup │
│ Generate StudyVault │
└──────────┬─────────────────┘
│
▼
┌────────────────────────────┐
│ Read & review notes │
│ in Obsidian │
└──────────┬─────────────────┘
│
▼
┌────────────────────────────┐
│ /tutor │
│ Take diagnostic quiz │◀──────────┐
└──────────┬─────────────────┘ │
│ │
▼ │
┌────────────────────────────┐ │
│ Review weak areas │ │
│ in Obsidian │ │
└──────────┬─────────────────┘ │
│ │
▼ │
┌────────────────────────────┐ │
│ /tutor │ │
│ Drill weak concepts │───────────┘
└────────────────────────────┘
Requirements
- Claude Code CLI installed and configured
- Obsidian (recommended) to open and navigate the generated vault
Repository Structure
tutor-skill/
├── skills/
│ ├── tutor-setup/ # Vault generation skill
│ │ ├── SKILL.md
│ │ └── references/
│ │ ├── templates.md
│ │ ├── codebase-workflow.md
│ │ ├── quality-checklist.md
│ │ └── codebase-templates.md
│ └── tutor/ # Interactive quiz skill
│ ├── SKILL.md
│ └── references/
│ └── quiz-rules.md
├── examples/
├── install.sh
├── uninstall.sh
├── README.md
└── LICENSE
Uninstall
./uninstall.sh
Or manually:
rm -rf ~/.claude/skills/tutor-setup
rm -rf ~/.claude/skills/tutor