Agent skill · writing content · roundtable02
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.
Why this skill is useful
Adds specific workflows for transforming various knowledge sources into structured study notes and onboarding materials, which the AI wouldn't reliably generate on its own.
What it needs
Requires poppler installed locally. About 4k tokens when loaded. Last updated 2026-02-28. 1,077 stars on the source repository.
What this skill does
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 Phase D1: Source Discovery & Extraction 1. Auto-scan CWD for /.pdf, /.txt, /.md, /.html, /.epub (exclude nodemodules/, .git/, dist/, build/, StudyVault/). Present for user confirmation. 2. Extract text (MANDATORY tools): PDF → pdftotext CLI ONLY (run via Bash tool). NEVER use the Read tool directly on PDF files — it renders pages as images and wastes 10-50x more tokens. Convert to .txt first, then Read the .txt file. If pdftotext is not installed, install it first: brew install poppler (macOS) or apt-get install poppler-utils (Linux). URL → WebFetch Other formats (.md, .txt, .html) → Read directly. 3. Read extracted .txt files — understand scope, structure, depth. Work exclusively from the converted text, never from the raw PDF. 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills roundtable02/tutor-setup