How do I install tutor-skills?

Run `npx skills add RoundTable02/tutor-skills` in your terminal. Alternatively, clone the repository manually and run `./install.sh` to install.

Which file formats are supported?

In document mode, it automatically scans PDF, TXT, MD, HTML, and EPUB files.

How does tutor-setup distinguish between document mode and codebase mode?

It checks the directory for project marker files like `package.json`, `pom.xml`, `build.gradle`, `Cargo.toml`, or `go.mod`. If found, it enters codebase mode; otherwise, it uses document mode.

What is the scoring criteria for the quizzes?

Each round has 4 questions with 4 options each and no hints. Proficiency is updated based on accuracy: 0–39% Weak, 40–69% Fair, 70–89% Good, 90–100% Mastered.

Which tools can this skill be used with?

The documentation notes it relies on npx skills and works with tools like Claude Code, Cursor, and Windsurf.

September 26, 2026

tutor-skills

AI & Machine Learning Prompt Engineering & Skill Management0

Get resource

A Claude Code skill that turns PDFs, documents, and codebases into an Obsidian study vault and tracks concept mastery through interactive quizzes.

MITObsidianClaude CodeCursorCode InputDocument InputText Output

Skill广场 Skill Packaging

安装 / 调用方式bash

```bash
npx skills add RoundTable02/tutor-skills
```

调用示例json

```bash
cd ~/study-materials/
claude
> /tutor-setup

claude
> /tutor
```

Product facts

Type: AI Skill & Agent
Category: AI & Machine Learning › Prompt Engineering & Skill Management
Pricing: Open source
Platforms: Obsidian · Claude Code · Cursor
License: MIT
Launched: Sep 26, 2026
Listed: Sep 26, 2026
Website: github.com

Overview

GitHub GitHub

## Introduction tutor-skills is a set of skills for Claude Code, providing two commands: `tutor-setup` and `tutor`. It converts various knowledge sources into a structured Obsidian StudyVault and delivers interactive quizzes on top of it, forming a complete learning loop from content ingestion to comprehension checks. ## Key Capabilities ### tutor-setup: Generate a StudyVault This skill automatically detects the working directory pattern: - **Document Mode**: Enabled when no project marker files are found. Scans PDF, TXT, MD, HTML, EPUB, and other formats, extracts content, and generates concept notes with comparison tables and ASCII diagrams. It also creates practice questions (using collapsible callouts for active recall) and builds a dashboard containing a Map of Content (MOC), quick references, and exam pitfalls. All notes are interconnected via `[[wiki-links]]`. - **Codebase Mode**: Enabled when project marker files such as `package.json`, `pom.xml`, or `Cargo.toml` are detected. Automatically identifies tech stacks, architectural patterns, and module boundaries, traces request and data flows, generates a note for each module, and provides onboarding exercises for new developers (code reading, configuration, debugging, extension). The generated StudyVault is organized into numbered folders, including a Dashboard, topic or module folders, and exercise folders. ### tutor: Interactive Quiz Tutor Runs against an existing StudyVault and tracks user mastery at the concept level. - **Session Types**: Based on current proficiency, offers diagnostic tests (for unmeasured areas), weak-point drills (for weak areas), self-selected chapter practice, and hard-mode reviews (for mastered material). - **Quiz Flow**: Each round presents 4 multiple-choice questions (4 options each, no hints). After grading, it explains mistakes and automatically updates concept files and the dashboard. - **Progress Tracking**: Uses emoji badges for proficiency levels (🟥 Weak 0–39%, 🟨 Fair 40–69%, 🟩 Good 70–89%, 🟦 Mastered 90–100%, ⬜ Unmeasured). Records attempts, correct answers, last test date, and mistake notes so previously missed concepts can be retested in new contexts later. ## Who It's For Ideal for developers, students, or technical teams who need to turn large volumes of documentation or codebases into structured study notes and reinforce knowledge through repeated quizzing.

Key features

Auto-generate a StudyVault: Use the /tutor-setup command to convert documents or codebases into a structured Obsidian study vault.
Document mode processing: Supports PDF, TXT, MD, HTML, EPUB, and more, generating concept notes, comparison tables, and ASCII diagrams.
Codebase mode analysis: Automatically detects tech stacks and architectural patterns, traces request and data flows, and generates modular notes.
Interactive quizzes: Launch quizzes via the /tutor command—4 multiple-choice questions per round, with explanations after grading.
Concept-level progress tracking: Marks proficiency with emoji badges and records attempts, correct answers, and mistake notes.
Multiple session types: Offers four quiz sessions—diagnostic tests, weak-point drills, self-selected chapters, and hard-mode reviews.
Active recall design: Practice questions use collapsible callouts to hide answers, supporting active recall learning.
Bidirectional link network: All generated notes reference each other via [[wiki-links]], building knowledge connections.
New developer onboarding: In codebase mode, generates onboarding exercises for code reading, configuration, debugging, and extension.

Releases

Notify me

Initial · tutor-skills

September 26, 2026

Q&A

How do I install tutor-skills?AI-generated: Run `npx skills add RoundTable02/tutor-skills` in your terminal. Alternatively, clone the repository manually and run `./install.sh` to install.
Which file formats are supported?AI-generated: In document mode, it automatically scans PDF, TXT, MD, HTML, and EPUB files.
How does tutor-setup distinguish between document mode and codebase mode?AI-generated: It checks the directory for project marker files like `package.json`, `pom.xml`, `build.gradle`, `Cargo.toml`, or `go.mod`. If found, it enters codebase mode; otherwise, it uses document mode.
What is the scoring criteria for the quizzes?AI-generated: Each round has 4 questions with 4 options each and no hints. Proficiency is updated based on accuracy: 0–39% Weak, 40–69% Fair, 70–89% Good, 90–100% Mastered.
Which tools can this skill be used with?AI-generated: The documentation notes it relies on npx skills and works with tools like Claude Code, Cursor, and Windsurf.