# Tutor Setup

Transforms knowledge sources into an Obsidian StudyVault.

- Repository: https://github.com/bevibing/tutor-skills (1377 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-02-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add bevibing/tutor-skills --skill tutor-setup -g -a claude-code -y`
Codex: `npx skills add bevibing/tutor-skills --skill tutor-setup -g -a codex -y`
Cursor: `npx skills add bevibing/tutor-skills --skill tutor-setup -g -a cursor -y`
Gemini CLI: `npx skills add bevibing/tutor-skills --skill tutor-setup -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/bevibing/tutor-skills/blob/HEAD/skills/tutor-setup/SKILL.md