Tutor Setup

Turns PDFs, codebases, or web sources into structured Obsidian study vaults with two auto-detected modes. Document mode extracts text from academic materials (mandates pdftotext to avoid token waste), maps topics to source pages, then generates concept notes with practice questions, comparison tables, and exam trap callouts. Codebase mode scans project markers like package.json or Cargo.toml, traces architecture and request flows, then builds onboarding notes per module with hands-on exercises for new developers. Both modes enforce wiki-linking, tag hierarchies, and a self-review checklist. Useful when you need to actually learn material rather than just highlight it, or when onboarding docs don't exist yet.

skills.sh installs: 2.1K
GitHub stars: 1.4K
last updated: Feb 28, 2026

View on GitHub

Install

$ npx -y skills add bevibing/tutor-skills --skill tutor-setup --agent claude-code

Installs into .claude/skills of the current project.

Files

Tutor Setup — Knowledge to Obsidian StudyVault

CWD Boundary Rule (ALL MODES)

NEVER access files outside the current working directory (CWD). All source scanning, reading, and vault output MUST stay within CWD and its subdirectories. If the user provides an external path, ask them to copy the files into CWD first.

Mode Detection

On invocation, detect mode automatically:

Check for project markers in CWD:
- package.json, pom.xml, build.gradle, Cargo.toml, go.mod, Makefile, *.sln, pyproject.toml, setup.py, Gemfile
If any marker found → Codebase Mode
If no marker found → Document Mode
Tie-break: If .git/ is the sole indicator and no source code files (*.ts, *.py, *.java, *.go, *.rs, etc.) exist, default to Document Mode.
Announce detected mode and ask user to confirm or override.