Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/RoundTable02/tutor-skills

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

tutor-skill

Name: tutor-skills
Author: RoundTable02

Two Claude Code skills that turn any knowledge source into an Obsidian StudyVault and then quiz you on it — closing the loop from content to comprehension.

How It Works

Documents / Code                    Obsidian                    Quiz Session
 ┌──────────────────┐           ┌──────────────────┐          ┌──────────────────┐
 │  PDF, MD, HTML,  │  /tutor   │   StudyVault/    │  /tutor  │  4 questions per  │
 │  EPUB, source    │──setup──▶ │   structured     │────────▶ │  round, graded,   │
 │  code projects   │           │   interlinked    │          │  concept tracking  │
 └──────────────────┘           │   notes + MOC    │          └────────┬─────────┘
                                └──────────────────┘                   │
                                         ▲                             │
                                         └─────── progress updates ────┘

Skills Overview

Skill Command Purpose Input Output

tutor-setup /tutor-setup Generate a StudyVault Documents or source code Obsidian vault with notes, dashboards, practice questions

tutor /tutor Interactive quiz tutor An existing StudyVault Quiz sessions with concept-level progress tracking

Quick Start

One-line install (recommended)

npx skills add RoundTable02/tutor-skills

Requires npx skills — works with Claude Code, Cursor, Windsurf, and more.

Manual install

git clone https://github.com/RoundTable02/tutor-skills.git
cd tutor-skills
./install.sh

Step 1: Generate a StudyVault

cd ~/study-materials/          # or any source code project
claude
> /tutor-setup

Step 2: Start Quizzing

claude
> /tutor

tutor-setup

Transforms knowledge sources into a structured Obsidian StudyVault. Mode is auto-detected:

Marker Found Mode

package.json, pom.xml, build.gradle, Cargo.toml, go.mod, etc. Codebase Mode

No project markers Document Mode

Document Mode

Turns PDFs, text files, web pages, and other sources into comprehensive study notes.

Auto-scans working directory for source files (PDF, TXT, MD, HTML, EPUB)
Extracts and analyzes content with verified source mapping
Generates concept notes with comparison tables, ASCII diagrams, and exam patterns
Creates practice questions with hidden answers (active recall via fold callouts)
Builds a dashboard with Map of Content (MOC), Quick Reference, and Exam Traps
Full interlinking with [[wiki-links]] across all notes

Phases

Phase Name Description

D1 Source Discovery Scan, extract, and verify source content mapping

D2 Content Analysis Build topic hierarchy and dependency map

D3 Tag Standard Define English kebab-case tag registry

D4 Vault Structure Create numbered folders per topic

D5 Dashboard MOC, Quick Reference, Exam Traps

D6 Concept Notes Structured notes with tables, diagrams, callouts

D7 Practice Questions Active recall with fold callouts (8+ per topic)

D8 Interlinking Cross-reference all notes with wiki-links

D9 Self-Review Verify against quality checklist

Generated structure

StudyVault/
  00-Dashboard/          # MOC + Quick Reference + Exam Traps
  01-&#x3C;Topic1>/           # Concept notes + practice questions
  02-&#x3C;Topic2>/
  ...

Codebase Mode

Generates a new-developer onboarding vault from a source code project.

Auto-detects tech stack, architecture patterns, and module boundaries
Traces request flows and data flows end-to-end
Creates per-module notes with key files, public interfaces, and dependency maps
Generates onboarding exercises (code reading, configuration, debugging, extension)
Builds a dashboard with architecture overview, module map, API surface, and getting started guide

Phases

Phase Name Description

C1 Project Exploration Scan files, detect tech stack, map layout

C2 Architecture Analysis Identify patterns, trace flows, map modules

C3 Tag Standard Define #arch-*, #module-*, #pattern-* registry

C4 Vault Structure Create dashboard + per-module folders

C5 Dashboard MOC with module map, API surface, getting started

C6 Module Notes Purpose, key files, interface, flow, dependencies

C7 Exercises Code reading, config, debugging, extension tasks

C8 Interlinking Cross-link all modules and exercises

C9 Self-Review Verify against quality checklist

Generated structure

StudyVault/
  00-Dashboard/          # MOC + Quick Reference + Getting Started
  01-Architecture/       # System overview, request flow, data flow
  02-&#x3C;Module1>/          # Per-module notes
  03-&#x3C;Module2>/
  ...
  NN-DevOps/             # Build, deploy, CI/CD
  NN+1-Exercises/        # Onboarding exercises

tutor

Interactive quiz tutor that tracks what you know and don't know at the concept level. Works with any StudyVault generated by tutor-setup.

Session Types

Type When Available Focus

Diagnostic Unmeasured areas (⬜) exist Broad assessment of new areas

Drill weak areas Weak areas (🟥/🟨) exist Targeted practice on struggles

Choose a section Always Study any area on demand

Hard-mode review All areas 🟩/🟦 Challenge mastered material

Quiz Flow

Detects your StudyVault and reads the learning dashboard
Presents session options based on your current proficiency
Delivers 4 questions per round (4 options each, zero hints)
Grades answers and explains mistakes
Updates concept files and dashboard automatically

Progress Tracking

Proficiency is tracked per area with emoji badges:

Badge Level Rate

🟥 Weak 0–39%

🟨 Fair 40–69%

🟩 Good 70–89%

🟦 Mastered 90–100%

⬜ Unmeasured No data

Concept-level tracking stores attempts, correct count, last tested date, and error notes for wrong answers — so drill sessions rephrase missed concepts in new contexts.

The Learning Cycle

┌────────────────────────────┐
           │   /tutor-setup             │
           │   Generate StudyVault      │
           └──────────┬─────────────────┘
                      │
                      ▼
           ┌────────────────────────────┐
           │   Read & review notes      │
           │   in Obsidian              │
           └──────────┬─────────────────┘
                      │
                      ▼
           ┌────────────────────────────┐
           │   /tutor                   │
           │   Take diagnostic quiz     │◀──────────┐
           └──────────┬─────────────────┘           │
                      │                              │
                      ▼                              │
           ┌────────────────────────────┐           │
           │   Review weak areas        │           │
           │   in Obsidian              │           │
           └──────────┬─────────────────┘           │
                      │                              │
                      ▼                              │
           ┌────────────────────────────┐           │
           │   /tutor                   │           │
           │   Drill weak concepts      │───────────┘
           └────────────────────────────┘

Requirements

Claude Code CLI installed and configured
Obsidian (recommended) to open and navigate the generated vault

Repository Structure

tutor-skill/
├── skills/
│   ├── tutor-setup/              # Vault generation skill
│   │   ├── SKILL.md
│   │   └── references/
│   │       ├── templates.md
│   │       ├── codebase-workflow.md
│   │       ├── quality-checklist.md
│   │       └── codebase-templates.md
│   └── tutor/                    # Interactive quiz skill
│       ├── SKILL.md
│       └── references/
│           └── quiz-rules.md
├── examples/
├── install.sh
├── uninstall.sh
├── README.md
└── LICENSE

Uninstall

./uninstall.sh

Or manually:

rm -rf ~/.claude/skills/tutor-setup
rm -rf ~/.claude/skills/tutor

License

MIT

Frequently Asked Questions

What is tutor-skills?⌄

tutor-skills is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by RoundTable02. A Claude Code skill that turns PDFs, docs, and codebases into Obsidian study vaults. It has 669 GitHub stars.

Is tutor-skills safe to use?⌄

Yes. tutor-skills passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install tutor-skills?⌄

Clone the repository with "git clone https://github.com/RoundTable02/tutor-skills" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is tutor-skills written in?⌄

tutor-skills is primarily written in Shell. It is open-source under RoundTable02 on GitHub, so you can review or fork the full source.

Are there alternatives to tutor-skills?⌄

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh tutor-skills against similar tools.

tutor-skills