What is Tutor Skills?
Tutor Skills is an open-source agentic learning framework designed for Claude Code, Cursor, and Windsurf via the Agent Skills standard. Created to bridge the gap between passive content consumption and active comprehension, Tutor Skills converts raw learning materials—ranging from PDFs, EPUBs, and web documentation to entire production codebases—into structured, interlinked Obsidian StudyVaults. Once indexed, an interactive AI tutor initiates spaced active-recall quiz sessions, tracking student mastery and highlighting knowledge traps at the individual concept level.
Core Skills & Architecture
/tutor-setup(StudyVault Generator): Automatically scans directories, detects source types (Document Mode for PDFs/markdown vs. Codebase Mode for repositories containingpackage.json,Cargo.toml, orgo.mod), and builds complete Obsidian vaults containing concept notes, comparison tables, ASCII architecture diagrams, and Map of Content (MOC) dashboards./tutor(Interactive Active-Recall Tutor): Launches focused, 4-question quiz rounds directly within the agent terminal or editor. Questions feature hidden answer callouts, difficulty adaptations, and concept-level mastery scores that feed updates back into the vault dashboard.- Zero-Hallucination Source Mapping: Every synthesized concept note and quiz question preserves deterministic citation anchors back to the original source text or line-numbered code file.
- Active Recall Fold Callouts: Practice questions are formatted with native Obsidian fold callouts (
> [!question]-), enabling self-testing without revealing answers accidentally.
CLI Quickstart & Agent Installation
Install Tutor Skills into your coding agent environment with a single command:
# Install via npx skills (Claude Code, Cursor, Windsurf)
npx skills add RoundTable02/tutor-skills
# Generate an Obsidian StudyVault from your materials or repo
cd ~/my-study-project
claude
> /tutor-setup
# Start an interactive quiz session
> /tutor
Technical Specifications
| Distribution Standard | Agent Skills (npx skills) |
|---|---|
| Supported Hosts | Claude Code, Cursor, Windsurf, Cline, Codex |
| Output Format | Obsidian Markdown Vault (.md with MOC and Callouts) |
| Supported Inputs | PDF, TXT, Markdown, HTML, EPUB, Full Codebases |
| License | Open Source (MIT License) |
| Official Repository | github.com/bevibing/tutor-skills |
Frequently Asked Questions
How does Tutor Skills handle codebases differently from documents?
When package manifest markers are detected, Tutor Skills enters Codebase Mode. It maps architecture patterns, execution entry points, and component relationships rather than generic prose, creating targeted developer onboarding quizzes.
Do I need Obsidian installed to use Tutor Skills?
While generated vaults are optimized for Obsidian’s graph view and fold callouts, all output consists of standard GitHub Flavored Markdown files compatible with VS Code, Foam, or any text editor.
Can I quiz myself on specific topics only?
Yes. The /tutor command allows you to target specific concept tags, weak-point dashboard areas, or recent chapters rather than running a random full-vault quiz.
Is an external API key required?
No external API key is needed beyond your agent’s existing model environment (Claude, OpenAI, or local model).