Turn Any Document Into an Obsidian Study Vault That Quizzes You Back

Reading material does not make it stick, and building flashcards by hand is its own procrastination trap. tutor-skills, a 1k-star MIT repo, splits the problem across two Claude Code skills: one turns your source material into a structured, interlinked Obsidian vault; the other quizzes you on it and remembers exactly which concepts you keep missing.

Why This Skill Matters

Study tooling usually stops at summarizing. This repo's two skills close the loop from content to comprehension. /tutor-setup generates a StudyVault — a dashboard with a map of content, concept notes with comparison tables and ASCII diagrams, and practice questions whose answers hide behind fold callouts for active recall. /tutor then runs quiz sessions against that vault: four questions per round, answers graded, mistakes explained, and concept files updated automatically after every round.

The vault doubles as durable notes. Everything cross-links through Obsidian [[wiki-links]], so the quiz loop and the reading loop reinforce each other: drill a weak area in the quiz, review the linked concept note, come back.

Installation

The one-line path uses npx skills (the Vercel Labs installer), which works with Claude Code, Cursor, Windsurf, and more:

npx skills add RoundTable02/tutor-skills

One heads-up: the repo now lives at bevibing/tutor-skills — the README's commands still carry the old RoundTable02 owner, which GitHub redirects (verified 2026-10-30). Prefer the manual route? Clone and run the installer script, then remove it later with ./uninstall.sh:

git clone https://github.com/RoundTable02/tutor-skills.git
cd tutor-skills
./install.sh

Requirements: Claude Code CLI, and Obsidian recommended for navigating the generated vault.

Real Workflow: Exam Prep From a Folder of PDFs

1. Put your material — PDFs, text files, markdown, HTML, EPUB — in one directory, start Claude Code there, and run:

/tutor-setup

Document Mode auto-detects when no project markers are present, then works through nine documented phases from source discovery to self-review: verifying source mapping, building a topic hierarchy, standardizing tags, creating numbered topic folders, and writing at least eight practice questions per topic with hidden answers.

2. Open the vault in Obsidian. 00-Dashboard/ holds the map of content, a quick reference, and an Exam Traps section; each 01-<Topic>/ folder holds concept notes plus its questions.

3. Read a topic, then take the first quiz:

/tutor

Real Workflow: The Drill Loop

The quiz session adapts to where you stand. /tutor offers a diagnostic session when unmeasured areas exist, a drill session when weak areas exist, free section choice anytime, and a hard-mode review once everything measures good or mastered. Each round is four four-option questions with zero hints.

Proficiency is tracked per area with badges spanning weak (0–39%), fair (40–69%), good (70–89%), and mastered (90–100%), with unmeasured areas marked separately. Concept-level tracking stores attempts, correct count, last-tested date, and error notes — so a drill session rephrases the concepts you missed in new contexts instead of repeating the same question.

For engineers, the same loop works on source code: point /tutor-setup at a project with a package.json, go.mod, or similar marker and Codebase Mode generates an onboarding vault — architecture overview, module notes with key files and dependency maps, and exercises in a dedicated folder.

Tips

• Run /tutor-setup with a clear goal in mind — the Exam Traps dashboard section is built for test prep, and exam patterns shape the generated notes.
• The README's learning cycle is read → diagnostic quiz → review weak notes → drill: keep each step in Obsidian so the wiki-links carry you between them.
• Practice questions hide answers behind fold callouts — answer before unfolding, or the active-recall design buys you nothing.
• Uninstall is clean: ./uninstall.sh, or delete ~/.claude/skills/tutor-setup and ~/.claude/skills/tutor.

When Not to Use This

The two skills are a pipeline, not independent tools: /tutor takes an existing StudyVault as its input, so there is no quizzing without a vault from /tutor-setup first. Document Mode's documented scan list is PDF, TXT, MD, HTML, and EPUB — video or audio material is not in it, so plan to convert those first. And the quiz format is fixed by design: four options per question, four questions per round, zero hints — this is recall practice with grades, not open-ended tutoring, and Obsidian is a recommendation the workflow leans on even though the vault itself is plain markdown.

See the leaderboard for more skills.