TUTOR SKILLS
A skill set that turns PDFs, docs, and codebases into structured Obsidian StudyVaults, then provides interactive quizzes with concept-level progress tracking.
Overview
Two skills work together:
- tutor-setup — Generates a StudyVault from source materials
- tutor — Interactive quiz tutor with mastery tracking
Documents / Code (PDF, MD, HTML, EPUB, source code)
↓ (/tutor-setup)
Obsidian StudyVault (structured notes, dashboards, practice questions)
↓ (/tutor)
Quiz Session (4 questions per round, scoring, concept tracking)
↓
Progress Updates
Skill 1: tutor-setup (StudyVault Generator)
Converts knowledge sources into a structured Obsidian StudyVault.
Modes
- Document Mode: For PDFs, text files, web pages → generates concept notes, comparison tables, ASCII diagrams, practice questions
- Codebase Mode: For source code projects → generates onboarding vault with architecture overview, module notes, exercises
Generation Phases (Document Mode: D1-D9)
- Source Discovery — scan, extract, validate
- Content Analysis — build topic hierarchy and dependency graph
- Tag Standard — define tag registry
- Vault Structure — create numbered folders
- Dashboard — MOC, quick reference, exam traps
- Concept Notes — structured notes with tables, diagrams, callouts
- Practice Questions — active recall foldable blocks (8+ per topic)
- Interlinking — cross-reference all notes with wiki links
- Self-Review — validate against quality checklist
Output Structure
StudyVault/
00-Dashboard/ # MOC + Quick Ref + Exam Traps
01-<Topic1>/ # Concept notes + Practice questions
02-<Topic2>/
...
Skill 2: tutor (Interactive Quiz Tutor)
Works on any StudyVault generated by tutor-setup.
Session Types
- Diagnostic — broad assessment of unmeasured areas (⬜)
- Drill weak areas — targeted practice on weak spots (🟥/🟨)
- Choose a section — study any area on demand
- Hard-mode review — challenge mastered material (🟩/🟦)
Quiz Flow
- Detect StudyVault and read learning dashboard
- Present session options based on current mastery
- Deliver 4 questions per round (4 choices each, no hints)
- Grade answers and explain errors
- Auto-update concept files and dashboard
Progress Tracking
- 🟥 Weak: 0–39%
- 🟨 Fair: 40–69%
- 🟩 Good: 70–89%
- 🟦 Mastered: 90–100%
- ⬜ Unmeasured: no data
Quick Start
# Install
npx skills add RoundTable02/tutor-skills
# Step 1: Generate StudyVault
cd ~/study-materials/
claude
> /tutor-setup
# Step 2: Start Quiz
claude
> /tutor
Requirements
- Claude Code CLI or compatible agent
- Obsidian (recommended) for browsing generated vaults
1---2name: tutor-skills3description: Turn PDFs, docs, and codebases into Obsidian StudyVaults with structured notes, then quiz yourself with concept-level progress tracking. Use when users want to study documents, create study materials from files, generate practice questions, or track learning mastery.4---5
6# TUTOR SKILLS
7
8A skill set that turns PDFs, docs, and codebases into structured Obsidian StudyVaults, then provides interactive quizzes with concept-level progress tracking.
9
10## Overview
11
12Two skills work together:
13
141. **tutor-setup** — Generates a StudyVault from source materials
152. **tutor** — Interactive quiz tutor with mastery tracking
16
17```
18Documents / Code (PDF, MD, HTML, EPUB, source code)
19 ↓ (/tutor-setup)
20Obsidian StudyVault (structured notes, dashboards, practice questions)
21 ↓ (/tutor)
22Quiz Session (4 questions per round, scoring, concept tracking)
23 ↓
24Progress Updates
25```
26
27## Skill 1: tutor-setup (StudyVault Generator)
28
29Converts knowledge sources into a structured Obsidian StudyVault.
30
31### Modes
32
33- **Document Mode**: For PDFs, text files, web pages → generates concept notes, comparison tables, ASCII diagrams, practice questions
34- **Codebase Mode**: For source code projects → generates onboarding vault with architecture overview, module notes, exercises
35
36### Generation Phases (Document Mode: D1-D9)
37
381. Source Discovery — scan, extract, validate
392. Content Analysis — build topic hierarchy and dependency graph
403. Tag Standard — define tag registry
414. Vault Structure — create numbered folders
425. Dashboard — MOC, quick reference, exam traps
436. Concept Notes — structured notes with tables, diagrams, callouts
447. Practice Questions — active recall foldable blocks (8+ per topic)
458. Interlinking — cross-reference all notes with wiki links
469. Self-Review — validate against quality checklist
47
48### Output Structure
49
50```
51StudyVault/
52 00-Dashboard/ # MOC + Quick Ref + Exam Traps
53 01-<Topic1>/ # Concept notes + Practice questions
54 02-<Topic2>/
55 ...
56```
57
58## Skill 2: tutor (Interactive Quiz Tutor)
59
60Works on any StudyVault generated by tutor-setup.
61
62### Session Types
63
641. **Diagnostic** — broad assessment of unmeasured areas (⬜)
652. **Drill weak areas** — targeted practice on weak spots (🟥/🟨)
663. **Choose a section** — study any area on demand
674. **Hard-mode review** — challenge mastered material (🟩/🟦)
68
69### Quiz Flow
70
711. Detect StudyVault and read learning dashboard
722. Present session options based on current mastery
733. Deliver 4 questions per round (4 choices each, no hints)
744. Grade answers and explain errors
755. Auto-update concept files and dashboard
76
77### Progress Tracking
78
79- 🟥 Weak: 0–39%
80- 🟨 Fair: 40–69%
81- 🟩 Good: 70–89%
82- 🟦 Mastered: 90–100%
83- ⬜ Unmeasured: no data
84
85## Quick Start
86
87```bash
88# Install
89npx skills add RoundTable02/tutor-skills
90
91# Step 1: Generate StudyVault
92cd ~/study-materials/
93claude
94> /tutor-setup
95
96# Step 2: Start Quiz
97claude
98> /tutor
99```
100
101## Requirements
102
103- Claude Code CLI or compatible agent
104- Obsidian (recommended) for browsing generated vaults
infometa