tutor-setup
Transforms knowledge sources into an Obsidian StudyVault. Two modes: (1) Document Mode — PDF/text/web sources → study notes with practice questions. (2) Codebase Mode — source code project → onboarding vault for new developers. Mode is auto-detected based on project markers in CWD.
npx skills add bevibing/tutor-skills --skill tutor-setup --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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: 1. **Check for project markers** in CWD: - `package.json`, `pom.xml`, `build.gradle`, `Cargo.toml`, `go.mod`, `Makefile`, `*.sln`, `pyproject.toml`, `setup.py`, `Gemfile` 2. **If any marker found** → **Codebase Mode** 3. **If no marker found** → **Document Mode** 4. **Tie-break**: If `.git/` is the sole indicator and no source code files (`*.ts`, `*.py`, `*.java`, `*.go`, `*.rs`, etc.) exist, default to Document Mode. 5. Announce detected mode and ask user to confirm or override. --- ## Document Mode > Transforms knowledge sources (PDF, text, web, epub) into study notes. > Templates: [templates.md](references/templates.md) ### Phase D1: Source Discovery & Extraction 1. **Auto-scan CWD** for `**/*.pdf`, `**/*.txt`, `**/*.md`, `**/*.html`, `**/*.epub` (exclude `node_modules/`, `.git/`, `dist/`, `build
- CWD Boundary Rule (ALL MODES)
- Mode Detection
- Document Mode
- Phase D1: Source Discovery & Extraction
- Phase D2: Content Analysis
- Phase D3: Tag Standard
- Phase D4: Vault Structure
- Phase D5: Dashboard Creation
- Phase D6: Concept Notes
- Phase D7: Practice Questions
- Phase D8: Interlinking
- Phase D9: Self-Review (MANDATORY)
- Codebase Mode
- Phase Summary
pdftotext "source.pdf" "/tmp/source.txt"
What does the tutor-setup skill do?
Transforms knowledge sources into an Obsidian StudyVault. Two modes: (1) Document Mode — PDF/text/web sources → study notes with practice questions. (2) Codebase Mode — source code project → onboarding vault for new developers. Mode is auto-detected based on project markers in CWD.
How do I install it?
Run `npx skills add bevibing/tutor-skills --skill tutor-setup --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From bevibing/tutor-skills, a repository with 1,073 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.