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