roundtable02-tutor-skills-1

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