/ Directory / Playground / tutor-skills
← All servers ↗ GitHub
● Community bevibing ⚡ Instant

tutor-skills

by bevibing · bevibing/tutor-skills

Two skills — tutor-setup turns PDFs/docs/codebases into an Obsidian study vault; tutor then quizzes you with progress tracking and spaced review.

Pairs content ingestion with interactive quizzing. tutor-setup scans your sources (PDFs, text, HTML, or code), extracts concepts with verified source mapping, and builds an Obsidian vault with wiki-linked notes, diagrams, and questions. tutor runs rounds of 4 questions with emoji-tracked mastery, diagnostic sessions, drills, and hard-mode reviews.

▶ Watch demo 📦 Install 💡 Use Cases

Why use it

Key features

Live Demo

What it looks like in practice

tutor-skill.replay ▶ ready
0/0

Install

Author repository · Claude Skills documentation

Use Cases

Real-world ways to use tutor-skills

Turn a 400-page textbook PDF into a study vault you can actually use

👤 Students and self-learners ⏱ ~90 min intermediate

When to use: You have a textbook and would rather quiz yourself than re-read it.

Prerequisites
  • Obsidian installed — obsidian.md — free
  • Claude Code CLI — Required for running the skills
Flow
  1. Run tutor-setup
    Use tutor-setup on ./textbook.pdf — build the vault at ~/vaults/calc.✓ Copied
    → Vault created with chapter notes, concept maps, and question bank
  2. Start a study session
    Use tutor. Start a diagnostic session on chapter 3.✓ Copied
    → 4 questions with grading and mastery update
  3. Review weak areas
    Show my weak concepts and drill them.✓ Copied
    → Targeted drill on lowest-mastery concepts

Outcome: A personal study vault plus a working retention loop.

Pitfalls
  • PDFs with poor OCR yield low-quality notes — Run OCR with a better tool first if the source is image-based
Combine with: human-skill-tree-skill

Onboard to an unfamiliar codebase via guided quizzing

👤 New hires and contractors ⏱ ~120 min intermediate

When to use: You inherited a 50k-line codebase and reading it linearly isn't working.

Flow
  1. Ingest the repo
    Use tutor-setup on ~/src/acme-api. Trace the architecture and build onboarding exercises.✓ Copied
    → Vault with module map, architecture diagrams, and exercise questions
  2. Run onboarding exercises
    Use tutor. Start the onboarding track.✓ Copied
    → Exercises that force you to navigate the code to answer

Outcome: Faster ramp-up than reading docs cover-to-cover.

Pitfalls
  • Generated exercises too shallow — Ask tutor-setup to focus on specific modules rather than the whole repo
Combine with: filesystem

Combinations

Pair with other MCPs for X10 leverage

tutor-skill + human-skill-tree-skill

Document-centric (tutor) + dialogue-centric (human-skill-tree)

Use tutor on my textbook, then switch to human-skill-tree for Socratic discussion of the hard concepts.✓ Copied
tutor-skill + filesystem

Save progress summaries outside the vault for version control

Every week, snapshot my mastery report to ~/learning-log/.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
tutor-setup source files (PDF/text/HTML/code) Start of a new study topic LLM tokens for extraction
tutor (quiz rounds) vault + focus topic Regular study sessions Tokens per round
Diagnostic mode topic Start of topic or after time away Tokens
Drill mode weak concepts Mid-study reinforcement Tokens
Hard-mode review mastered concepts Confidence check before exam Tokens

Cost & Limits

What this costs to run

API quota
None
Tokens per call
Setup can be heavy (20-100k tokens for a big PDF). Quizzes are light (2-5k per round).
Monetary
Free — skill is local. Obsidian is free.
Tip
Split large textbooks by chapter for setup to keep ingestion manageable.

Security

Permissions, secrets, blast radius

Credential storage: No credentials — skill is prompts + local file ops
Data egress: None — everything runs locally

Troubleshooting

Common errors and fixes

Vault notes missing concepts from the source

Re-run tutor-setup with chapter-level focus; full-book in one pass can skim.

Questions feel too easy

Switch to hard-mode review or ask tutor for application-level questions.

Obsidian doesn't show the wiki-links

Check vault settings; enable backlinks and graph view plugins.

Alternatives

tutor-skills vs others

AlternativeWhen to use it insteadTradeoff
human-skill-tree-skillYou prefer dialogue-based learning without a document vaultDifferent modality — no persistent vault
AnkiYou want pure SRS without the AI tutoring layerStronger SRS, no content generation

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills

Continue exploring

Related tools and workflows

Choose another guide for your workflow, or explore a collection.

Browse all topic collections → · See 29 new official additions →