Agent skill

StudyVault Quiz Tutor

by bevibing in bevibing/tutor-skills

Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

MITAuto-check passedEducation

Install StudyVault Quiz Tutor

skills CLI
$ npx skills add bevibing/tutor-skills --skill tutor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bevibing/tutor-skills tutor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bevibing/tutor-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tutor .claude/skills/tutor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tutor
GitHub stars
1.3k
Token cost
~1.4k tokens
SKILL.md length
518 words
Files
2 (incl. references)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

  • Works in 7 steps: Detect Language → Discover Vault → Ask Session Type → …
  • Taking a diagnostic of what you know across a StudyVault
  • SKILL.md covers File Structure, Workflow, Dashboard Template and Concept File Template, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent finds the StudyVault in your project, reads its compact dashboard and asks what kind of session you want, offering options based on the dashboard: a diagnostic for unmeasured areas, drilling named weak areas, choosing a section, or a hard-mode review once everything is strong. It answers in your language and stops if no vault exists.

Each round builds exactly four single-select questions with four options each from the section's markdown files, following a quiz-rules reference that allows no hints. Weak concepts are rephrased in new contexts instead of repeated. Results are graded in a table with explanations, and progress is tracked at concept level in per-area files holding attempts, correct counts, dates, status and error notes, while the dashboard keeps only aggregated numbers.

When your agent uses it

  • Taking a diagnostic of what you know across a StudyVault
  • Reviewing a specific section with a short quiz
  • Drilling concepts you got wrong in earlier sessions
  • Checking learning progress on the dashboard

Example prompts

  • “Quiz me on the networking section of my StudyVault.”
  • “Run a diagnostic on everything I have not been tested on yet.”
  • “Drill my weak areas from the earlier sessions.”

Requirements

  • An Obsidian StudyVault folder in the project

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Detect Language
  2. Discover Vault
  3. Ask Session Type
  4. Build Questions
  5. Present Quiz
  6. Grade & Explain
  7. Update Files

What it can do on your machine

Read from SKILL.md and the folder at commit 397110c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

StudyVault Quiz Tutor loads about 1.4k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 94 tokens; SKILL.md has 518 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bevibing/tutor-skills at commit 397110c, republished under its MIT licence (© bevibing). 518 words, ~1,396 tokens.

Download SKILL.mdSave it as .claude/skills/tutor/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
tutor
description
Interactive quiz tutor for Obsidian StudyVault learning. Use when the user wants to: (1) Take a diagnostic assessment of their knowledge, (2) Study or review specific sections/topics, (3) Drill weak areas identified in previous sessions, (4) Check their learning progress or dashboard, or says things like "quiz me", "test me", "let's study", "/tutor", "학습", "퀴즈", "평가".

Tutor Skill

Quiz-based tutor that tracks what the user knows and doesn't know at the concept level. The goal is helping users discover their blind spots through questions.

File Structure

StudyVault/
├── *dashboard*              ← Compact overview: proficiency table + stats
└── concepts/
    ├── {area-name}.md       ← Per-area concept tracking (attempts, status, error notes)
    └── ...
  • Dashboard: Only aggregated numbers. Links to concept files. Stays small forever.
  • Concept files: One per area. Tracks each concept with attempts, correct count, date, status, and error notes. Grows proportionally to unique concepts tested (bounded).

Workflow

Phase 0: Detect Language

Detect user's language from their message → {LANG}. All output and file content in {LANG}.

Phase 1: Discover Vault
  1. Glob **/StudyVault/ in project
  2. List section directories
  3. Glob **/StudyVault/*dashboard* to find dashboard
  4. If found, read it. Preserve existing file path regardless of language.
  5. If not found, create from template (see Dashboard Template below)

If no StudyVault exists, inform user and stop.

Phase 2: Ask Session Type

MANDATORY: Use AskUserQuestion to let the user choose what to do. Analyze the dashboard to build context-aware options, then present them.

Read the dashboard proficiency table and build options based on current state:

  1. If unmeasured areas (⬜) exist → include "Diagnostic" option targeting those areas
  2. If weak areas (🟥/🟨) exist → include "Drill weak areas" option naming the weakest area(s)
  3. Always include "Choose a section" option so the user can pick any area
  4. If all areas are 🟩/🟦 → include "Hard-mode review" option

Present these as an AskUserQuestion with header "Session" and concise descriptions showing which areas each option targets. The user MUST select before proceeding.

Phase 3: Build Questions
  1. Read markdown files in target section(s)
  2. If drilling weak area: also read concepts/{area}.md to find 🔴 unresolved concepts — rephrase these in new contexts (don't repeat the same question)
  3. Craft exactly 4 questions following references/quiz-rules.md

CRITICAL: Read references/quiz-rules.md before crafting ANY question. Zero hints allowed.

Phase 4: Present Quiz

Use AskUserQuestion:

  • 4 questions, 4 options each, single-select
  • Header: "Q1. Topic" (max 12 chars)
  • Descriptions: neutral, no hints
Show full SKILL.md (203 more words)Show less
Phase 5: Grade & Explain
  1. Show results table (question / correct answer / user answer / result)
  2. Wrong answers: concise explanation
  3. Map each question to its area
Phase 6: Update Files
1. Update concept file (concepts/{area}.md)

For each question answered:

  • New concept: Add row to table + if wrong, add error note under ### 오답 메모 (or localized equivalent)
  • Existing 🔴 concept answered correctly: Increment attempts & correct, change status to 🟢, keep error note (learning history)
  • Existing 🟢 concept answered wrong again: Increment attempts, change status back to 🔴, update error note

Table format:

markdown
| Concept | Attempts | Correct | Last Tested | Status |
|---------|----------|---------|-------------|--------|
| concept name | 2 | 1 | 2026-02-24 | 🔴 |

Error notes format (only for wrong answers):

markdown
### Error Notes

**concept name**
- Confusion: what the user mixed up
- Key point: the correct understanding
2. Update dashboard
  • Recalculate per-area stats from concept files (sum attempts/correct across all concepts in that area)
  • Update proficiency badges: 🟥 0-39% · 🟨 40-69% · 🟩 70-89% · 🟦 90-100% · ⬜ no data
  • Update stats: total questions, cumulative rate, unresolved/resolved counts, weakest/strongest

Dashboard stays compact — no session logs, no per-question details.

Dashboard Template

Create when no dashboard exists. Filename localized to {LANG}. Example in English:

markdown
# Learning Dashboard

> Concept-based metacognition tracking. See linked files for details.

---

## Proficiency by Area

| Area | Correct | Wrong | Rate | Level | Details |
|------|---------|-------|------|-------|---------|
(one row per section, last column = [[concepts/{area}]] link)
| **Total** | **0** | **0** | **-** | ⬜ Unmeasured | |

> 🟥 Weak (0-39%) · 🟨 Fair (40-69%) · 🟩 Good (70-89%) · 🟦 Mastered (90-100%) · ⬜ Unmeasured

---

## Stats

- **Total Questions**: 0
- **Cumulative Rate**: -
- **Unresolved Concepts**: 0
- **Resolved Concepts**: 0
- **Weakest Area**: -
- **Strongest Area**: -

Concept File Template

Create per area when first question is asked. Example:

markdown
# {Area Name} — Concept Tracker

| Concept | Attempts | Correct | Last Tested | Status |
|---------|----------|---------|-------------|--------|

### Error Notes

(added as concepts are missed)

Important Reminders

  • ALWAYS read references/quiz-rules.md before creating questions
  • NEVER include hints in option labels or descriptions
  • NEVER use "(Recommended)" on any option
  • Randomize correct answer position
  • After grading, ALWAYS update both concept file AND dashboard
  • Communicate in user's language

© bevibing, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/tutor of bevibing/tutor-skills.

  • SKILL.md
  • references/quiz-rules.md

Open the folder on GitHubat commit 397110c

Compare with similar skills

StudyVault Quiz Tutor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

StudyVault Quiz Tutor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
StudyVault Quiz Tutor this skillbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT
Claude Certification Tutorrohitg00/ai-engineering-from-scratch65k—~3kAutomated safety check: PassMIT
Interactive Course BuilderXiaomiMiMo/MiMo-Code14k—~2.9kAutomated safety check: PassMIT
Learning Tutoringaipoch/medical-research-skills2k—~2.8kAutomated safety check: PassMIT
DeepTutor CLIHKUDS/DeepTutor41k—~2.3kAutomated safety check: PassApache-2.0
Project Mastery Coachtudoumashu/ai-memory-skillpack411—~1.8kAutomated safety check: PassMIT

Similar skills

  • Claude Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.

    65k GitHub stars~3k tokensUpdated yesterday
    EducationAuto-check passed
  • Interactive Course Builder

    XiaomiMiMo/MiMo-Code

    Turns a PDF, paper, document, URL or topic into a chapter-by-chapter course with exercises, feedback and review, and saves progress so you can resume later.

    14k GitHub stars~2.9k tokensUpdated 4 days ago
    EducationAuto-check passed
  • Learning Tutoring

    aipoch/medical-research-skills

    Learning tutoring planning and content production skill for creating study plans, generating exercises, writing answer explanations, and providing review/adjustment guidance; triggered by requests…

    2k GitHub stars~2.8k tokensUpdated 20 days ago
    EducationAuto-check passed
  • DeepTutor CLI

    HKUDS/DeepTutor

    Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.

    41k GitHub stars~2.3k tokensUpdated 3 days ago
    EducationAuto-check passed
  • Project Mastery Coach

    tudoumashu/ai-memory-skillpack

    Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities.

    411 GitHub stars~1.8k tokensUpdated 29 days ago
    EducationAuto-check passed
  • Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated today
    EducationAuto-check passed

More from bevibing/tutor-skills

  • Obsidian StudyVault Builder

    bevibing/tutor-skills

    Converts PDFs, text, web pages or a codebase into an Obsidian vault of study notes, practice questions, or a developer onboarding guide.

    1.3k GitHub stars~1.9k tokensUpdated 7 mo ago
    Auto-check: notes

Works with

Questions about StudyVault Quiz Tutor

What does StudyVault Quiz Tutor do?

Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds. The agent finds the StudyVault in your project, reads its compact dashboard and asks what kind of session you want, offering options based on the dashboard: a diagnostic for unmeasured areas, drilling named weak areas, choosing a section, or a hard-mode review once everything is strong. It answers in your language and stops if no vault exists.

When should I use StudyVault Quiz Tutor?

StudyVault Quiz Tutor fits situations like: taking a diagnostic of what you know across a StudyVault; reviewing a specific section with a short quiz; drilling concepts you got wrong in earlier sessions; checking learning progress on the dashboard.

How do I install StudyVault Quiz Tutor in Claude Code?

Run `npx skills add bevibing/tutor-skills --skill tutor -a claude-code`. Or copy the skill folder (skills/tutor in bevibing/tutor-skills) into .claude/skills/tutor in your project. Claude Code loads it when a task matches its description.

How do I install StudyVault Quiz Tutor in Codex?

Run `npx skills add bevibing/tutor-skills --skill tutor -a codex`. Or copy the skill folder (skills/tutor in bevibing/tutor-skills) into .agents/skills/tutor in your project. Codex loads it when a task matches its description.

Can I use StudyVault Quiz Tutor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bevibing/tutor-skills --skill tutor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tutor, .gemini/skills/tutor, .github/skills/tutor and .opencode/skills/tutor in your project.

What does StudyVault Quiz Tutor need to run?

SKILL.md names no scripts, command-line tools or credentials: StudyVault Quiz Tutor is instructions for the agent only. Our summary lists: An Obsidian StudyVault folder in the project.

Does StudyVault Quiz Tutor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is StudyVault Quiz Tutor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does StudyVault Quiz Tutor use?

StudyVault Quiz Tutor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does StudyVault Quiz Tutor use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 533 tokens, read only when the agent opens those files.

What are the alternatives to StudyVault Quiz Tutor?

Skills that share tags, products or a category with StudyVault Quiz Tutor: Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 65k stars), Interactive Course Builder (XiaomiMiMo/MiMo-Code, 14k stars), Learning Tutoring (aipoch/medical-research-skills, 2k stars) and DeepTutor CLI (HKUDS/DeepTutor, 41k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains StudyVault Quiz Tutor?

bevibing (a GitHub organization) maintains it in bevibing/tutor-skills, which has 1,327 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on February 28, 2026.

Source: bevibing/tutor-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.