StudyVault Quiz Tutor
bevibing/tutor-skills
Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.
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.
$ npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install HKUDS/DeepTutor deeptutor-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
Claude Code skills documentation · loads skills from .claude/skills/
Install the "deeptutor-cli" agent skill from https://github.com/HKUDS/DeepTutor/tree/main into .claude/skills/deeptutor-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deeptutor-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install HKUDS/DeepTutor deeptutor-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "deeptutor-cli" agent skill from https://github.com/HKUDS/DeepTutor/tree/main into .agents/skills/deeptutor-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deeptutor-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install HKUDS/DeepTutor deeptutor-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "deeptutor-cli" agent skill from https://github.com/HKUDS/DeepTutor/tree/main into .cursor/skills/deeptutor-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deeptutor-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install HKUDS/DeepTutor deeptutor-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "deeptutor-cli" agent skill from https://github.com/HKUDS/DeepTutor/tree/main into .gemini/skills/deeptutor-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deeptutor-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install HKUDS/DeepTutor deeptutor-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "deeptutor-cli" agent skill from https://github.com/HKUDS/DeepTutor/tree/main into .github/skills/deeptutor-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deeptutor-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install HKUDS/DeepTutor deeptutor-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "deeptutor-cli" agent skill from https://github.com/HKUDS/DeepTutor/tree/main into .opencode/skills/deeptutor-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deeptutor-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
deeptutor-cliTeaches 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.
The skill covers first-time setup and day-to-day use. DeepTutor is installed with pip, either the full package for the Web app, a CLI-only package or an editable install from a source checkout, and it needs Python 3.11 or newer. `deeptutor init` runs a guided wizard through ports, LLM, embedding, search and review, writing the same settings the Web Settings page uses; `--cli` skips the ports step and `--home` targets a specific workspace.
Commands are grouped by area. `deeptutor chat` opens an interactive session and can start with a capability such as deep solve, quiz generation, deep research, visualize, math animation or mastery path, with options for knowledge base, session, notebook, language and tools like brainstorm, web search, paper search and reasoning. Further groups cover creating and searching knowledge bases from documents, managing partners (IM-connected learning companions), searching and installing skills from the ClawHub hub, interactive Books, learning memory, sessions and notebooks, and starting the API server or the full Web app.
Read from SKILL.md and the folder at commit f07029c. It shows what the files ask for, not the result of running them.
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.
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
pipFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
DeepTutor CLI loads about 2.3k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 407 words of instructions outside code blocks.
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.
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); the scripts in this folder are not scanned.
The full file from HKUDS/DeepTutor at commit f07029c, republished under its Apache-2.0 licence (© HKUDS). 407 words, ~2,260 tokens.
.claude/skills/deeptutor-cli/SKILL.md (or your agent's skills folder). This skill also uses 4097 other files; get the full folder from GitHub.Teach your AI agent to configure, manage, and use DeepTutor — an intelligent learning platform — entirely through the command line.
Use this skill when the user wants to:
pip install deeptutor for the full Web app, pip install deeptutor-cli for CLI-only, or pip install -e . from a source checkoutdeeptutor init for first-time interactive setup. It walks a guided wizard (ports → LLM → embedding → search → review) and writes the same settings as the Web Settings page under data/user/settings. Add --cli to skip the ports step for CLI-only use, or --home <path> to target a specific workspace.# Interactive REPL
deeptutor chat
deeptutor chat --capability deep_solve --kb my-kb --tool rag --tool web_search
# One-shot capability execution
deeptutor run chat "Explain Fourier transform"
deeptutor run deep_solve "Solve x^2 = 4" --tool rag --kb textbook
deeptutor run deep_question "Linear algebra" --config num_questions=5
deeptutor run deep_research "Attention mechanisms" --kb papers --config mode=report --config depth=standard
deeptutor run visualize "Plot the unit circle"
deeptutor run math_animator "Visualize a Fourier series"
# Capabilities accepted by `run` / `chat -c`:
# chat, deep_solve, deep_question, deep_research, visualize, math_animator, mastery_path
# Options for `run`:
# --session <id> Resume existing session
# --tool/-t <name> Enable tool (repeatable)
# --kb <name> Knowledge base (repeatable)
# --notebook-ref <ref> Notebook reference, "<notebook_id>:<rec1>,<rec2>" (repeatable)
# --history-ref <id> Referenced session id (repeatable)
# --language/-l <code> Response language (default: en)
# --config <key=value> Capability config (repeatable)
# --config-json <json> Capability config as JSON
# --format/-f <fmt> Output format: rich | json (default: rich)deeptutor chat accepts the same --session / --tool / --kb / --notebook-ref / --history-ref / --language / --config / --config-json options, plus --capability/-c <name> to set the initial capability.
Tools for --tool / -t: user-toggleable tools are brainstorm, web_search, paper_search, reason, geogebra_analysis, imagegen, and videogen. Context-gated tools (rag, exec, read_source, web_fetch, github, ask_user, …) auto-mount when their context is present, but can also be force-enabled with --tool. Run deeptutor plugin list for the full registered set.
deeptutor kb list [--format rich|json] # List all knowledge bases
deeptutor kb info <name> # Show knowledge base details (JSON)
deeptutor kb create <name> --doc file.pdf # Create from documents (--doc/-d repeatable)
deeptutor kb create <name> --docs-dir ./papers # ...or from a directory of documents
deeptutor kb add <name> --doc more.pdf # Add documents incrementally
deeptutor kb search <name> "query text" [--mode hybrid] [--format rich|json]
deeptutor kb eval <name> --dataset qa.jsonl [--top-k 5] [--mode hybrid] [--save report.json]
# Scores retrieval quality against a QA set (JSONL: {"query": ..., "gold": [...]});
# reports Recall@k / Precision@k / nDCG@k / MRR / MAP / Hit@k per case and averaged.
deeptutor kb set-default <name> # Set as default KB
deeptutor kb delete <name> [--force] # Delete a knowledge basePartners are IM-connected learning companions (the former "TutorBot").
deeptutor partner list # List all partners
deeptutor partner create <id> -n "My Tutor" # Create and start a new partner
# -n/--name <text> Display name
# -s/--soul <md> Soul markdown (the persona)
# -m/--model <id> Model override
deeptutor partner start <id> # Start a partner
deeptutor partner stop <id> # Stop a running partnerInstall and manage skills, including packages from external hubs (ClawHub).
Hub refs use <hub>:<slug>[@version] (the hub prefix defaults to clawhub).
deeptutor skill search "flashcards" [--hub clawhub] [--limit 10]
deeptutor skill install clawhub:some-skill[@1.2.0] [--name local-name] [--force] [--allow-unverified]
deeptutor skill list # List local skills (with hub provenance)
deeptutor skill remove <name> # Remove a user-layer skillMaintenance commands for the BookEngine (authoring/reading is via the Web app).
deeptutor book list # List all books (flags stale pages)
deeptutor book health <book_id> # Inspect KB drift + log.md health
deeptutor book refresh-fingerprints <book_id> # Re-snapshot KB fingerprintsdeeptutor memory show [<target>] # target: L3 (all global docs, default) | L2 (all surfaces) | a doc name (e.g. profile, chat)
deeptutor memory clear [<target>] # target: all (default) | trace (all L1) | a surface name (clears that surface's L1)
# --force/-f Skip confirmationdeeptutor session list [--limit 20] # List sessions
deeptutor session show <id> [--format rich|json] # View session messages
deeptutor session open <id> # Resume session in the REPL
deeptutor session rename <id> --title "..." # Rename a session
deeptutor session delete <id> # Delete a sessiondeeptutor notebook list # List notebooks
deeptutor notebook create <name> [--description "..."]
deeptutor notebook show <notebook_id> [--format rich|json]
deeptutor notebook add-md <notebook_id> <file.md> [--title "..."] [--type chat|question|research|solve]
deeptutor notebook replace-md <notebook_id> <record_id> <file.md>
deeptutor notebook remove-record <notebook_id> <record_id>deeptutor provider login openai-codex # OAuth login for OpenAI Codex
deeptutor provider login github-copilot # Validate an existing Copilot auth sessiondeeptutor config show # Print resolved configuration
deeptutor plugin list # List registered tools and capabilities
deeptutor plugin info <name> # Show a tool/capability's schema + availability
deeptutor serve [--host 0.0.0.0] [--port 8001] [--reload] # Start the API server
deeptutor start [--home <path>] # Launch backend + frontend together
deeptutor init [--cli] [--home <path>] # Create/update workspace settingsInside deeptutor chat, use these:
| Command | Effect |
|---|---|
/quit | Exit REPL |
/session | Show current session id |
/status | Print the current REPL state |
/new or /clear | Start a new session context |
/regenerate or /retry | Re-run the last user message |
/tool on|off <name> | Toggle a tool |
/cap <name> | Switch capability |
/kb <name>|none | Set or clear knowledge base |
/history add <id> / /history clear | Manage history references |
/notebook add <ref> / /notebook clear | Manage notebook references |
/show last|<n> | Expand a captured tool result or thinking block |
/refs | Show all active references |
/config show|set|clear | Manage capability config |
First-time setup:
cd DeepTutor
pip install -e .
deeptutor init # Interactive guided setup (add --cli for CLI-only)Daily learning:
deeptutor chat --kb textbook --tool rag --tool web_searchBuild a knowledge base from documents:
deeptutor kb create physics --doc ch1.pdf --doc ch2.pdf
deeptutor run chat "Explain Newton's third law" --kb physics --tool ragGenerate quiz questions:
deeptutor run deep_question "Thermodynamics" --kb physics --config num_questions=5Run the full Web app locally:
deeptutor start # backend + frontend; Ctrl+C to stop© HKUDS, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 4,097 other files (scripts, assets) in the repository root of HKUDS/DeepTutor.
Open the folder on GitHubat commit f07029c
DeepTutor CLI 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| DeepTutor CLI this skillHKUDS/DeepTutor | 41k | — | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| StudyVault Quiz Tutorbevibing/tutor-skills | 1.3k | — | ~1.4k | Automated safety check: Pass | MIT | |
| AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch | 65k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Claude Certification Tutorrohitg00/ai-engineering-from-scratch | 65k | — | ~3k | Automated safety check: Pass | MIT | |
| Zone of Proximal Development Practice LessonsTHU-MAIC/OpenMAIC | 40k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Generate Verifiers Envadithya-s-k/FineEnvs | 421 | 1 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 |
bevibing/tutor-skills
Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.
rohitg00/ai-engineering-from-scratch
Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.
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.
THU-MAIC/OpenMAIC
Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.
adithya-s-k/FineEnvs
Builds a Verifiers (PrimeIntellect) variant of an RL environment.
rohitg00/ai-engineering-from-scratch
Teaches the next lesson of the AI Engineering from Scratch curriculum in the terminal, quizzes you at the end and records your progress.
HKUDS/DeepTutor
Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.
HKUDS/DeepTutor
Reads, extracts from, creates, merges, splits, watermarks, encrypts and fills PDF files with pdfplumber, pypdf and reportlab inside a Python sandbox.
HKUDS/DeepTutor
Explains how to design and write DeepTutor skills: the SKILL.md anatomy, a trigger-focused description, concise content and progressive disclosure into reference files.
HKUDS/DeepTutor
Reads, creates and edits Excel workbooks with openpyxl, including formulas, styles, charts and CSV or TSV tables, with advice on formula values openpyxl cannot compute.
Works with
Categories
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. The skill covers first-time setup and day-to-day use.11 or newer.
DeepTutor CLI fits situations like: setting up DeepTutor for the first time; creating a knowledge base from PDFs and chatting against it; running quiz generation or deep research from the terminal; starting the DeepTutor API server or Web app.
Run `npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a claude-code`. Or copy the skill folder (the HKUDS/DeepTutor repository) into .claude/skills/deeptutor-cli in your project. Claude Code loads it when a task matches its description.
Run `npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a codex`. Or copy the skill folder (the HKUDS/DeepTutor repository) into .agents/skills/deeptutor-cli in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/DeepTutor --skill deeptutor-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deeptutor-cli, .gemini/skills/deeptutor-cli, .github/skills/deeptutor-cli and .opencode/skills/deeptutor-cli in your project.
Going by SKILL.md and its folder, DeepTutor CLI needs the command-line tools its instructions call (pip). Our summary lists: Python 3.11 or newer; DeepTutor installed with `pip install deeptutor` or `deeptutor-cli`; LLM and embedding settings from `deeptutor init`.
SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
DeepTutor CLI is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.3k tokens (SKILL.md is roughly 9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with DeepTutor CLI: StudyVault Quiz Tutor (bevibing/tutor-skills, 1.3k stars), AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 65k stars), Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 65k stars) and Zone of Proximal Development Practice Lessons (THU-MAIC/OpenMAIC, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
HKUDS (a GitHub organization) maintains it in HKUDS/DeepTutor, which has 40,857 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 4, 2026.
Source: HKUDS/DeepTutor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.