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