RoundTable02/tutor-skills logo

RoundTable02/tutor-skills

Free

Transform docs or codebases into interactive StudyVaults

FreeFree tier
Inputs: text
Type
Open Source

About RoundTable02/tutor-skills

Tutor-skills is an open-source Claude Code skill set that transforms any knowledge source—documents, PDFs, or codebases—into an Obsidian StudyVault and then quizzes you on the material. It consists of two commands: /tutor-setup (converts content into a structured vault with concept notes, dashboards, and practice questions) and /tutor (runs interactive quiz sessions with concept-level progress tracking). Document mode auto-scans working directories for PDF, TXT, MD, HTML, and EPUB files, while codebase mode detects project markers (e.g., package.json, pom.xml) and generates onboarding vaults with architecture analysis and exercises. The output is a fully interlinked Obsidian vault with wiki-links, active recall fold callouts, and a Map of Content. Installable via npx skills or manual clone. Works with Claude Code, Cursor, Windsurf, and other compatible AI assistants.

Key Features

Auto-scans working directory for source files (PDF, TXT, MD, HTML, EPUB) in Document Mode
Generates structured concept notes with comparison tables, ASCII diagrams, and exam patterns
Creates active recall practice questions using fold callouts (8+ per topic)
Builds a dashboard with Map of Content (MOC), Quick Reference, and Exam Traps
Full interlinking with [[wiki-links]] across all notes
Codebase Mode auto-detects tech stack, architecture patterns, and module boundaries for developer onboarding
Generates end-to-end request/data flow traces and onboarding code reading exercises
Interactive quiz sessions with concept-level progress tracking and grading
Works with multiple AI assistants: Claude Code, Cursor, Windsurf, and more

Pros & Cons

Pros
  • Free and open-source with a permissive license
  • Dual functionality: content conversion and interactive quizzing in one system
  • Supports multiple input formats: PDF, Markdown, HTML, EPUB, and source code
  • Output is a fully structured Obsidian vault with interlinked notes, dashboards, and practice questions
  • Active recall mechanism via hidden answers (fold callouts) enhances learning retention
  • Codebase mode provides valuable onboarding assistance for complex projects
  • Easy one-line install via npx skills
Cons
  • Primarily designed for Obsidian; output may require adaptation for other note-taking tools
  • Requires npx skills to be installed on the system, which adds a dependency
  • Initial setup may involve cloning a GitHub repo or running an install script
  • Quizzing feature is tied to the generated vault and may not work with external content
  • Relies on Claude Code or compatible AI assistants for execution

Best For

Self-study and exam preparation by converting textbooks or course materials into structured notes and quizzesOnboarding new developers to a codebase by generating a comprehensive architecture vaultCreating a personal knowledge base from research papers, web pages, or documentationActive recall studying with auto-generated practice questions and progress trackingConverting meeting notes or presentation slides into an interlinked Obsidian vault

FAQ

What file formats does tutor-setup support?
Document Mode supports PDF, TXT, MD, HTML, and EPUB files. Codebase Mode automatically detects project markers like package.json, pom.xml, build.gradle, Cargo.toml, go.mod, etc.
How does the quiz work?
The /tutor command starts an interactive quiz session from an existing StudyVault. Questions are presented in rounds of four, graded automatically, with concept-level progress tracking.
Which AI assistants are compatible?
The skills work with Claude Code, Cursor, Windsurf, and any other assistant that supports the npx skills framework.
What is the output structure of a StudyVault?
The vault includes a 00-Dashboard folder (with Map of Content, Quick Reference, Exam Traps), numbered topic folders with concept notes, and practice questions with fold callouts. All notes are interlinked using Obsidian wiki-links.
Can I use this with my existing Obsidian vault?
The skills generate a standalone StudyVault folder. You can import it into your existing Obsidian vault by copying the folder or linking it.