Skip to content
Back to search

tutor-skills

SkillWorks with Claude CodeGitHub

A Claude Code skill that turns PDFs, docs, and codebases into Obsidian study vaults

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bevibing-tutor-skills/badge.svg)](/listings/bevibing-tutor-skills)

HTML

<a href="/listings/bevibing-tutor-skills"><img src="/api/listings/bevibing-tutor-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

One-line install (recommended)

npx skills add RoundTable02/tutor-skills

> Requires [npx skills](https://github.com/vercel-labs/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

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 261 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # tutor-skill
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  3. [![Claude Code](https://img.shields.io/badge/Claude_Code-skill-blue)](https://docs.anthropic.com/en/docs/claude-code)
  4. [![Install with npx skills](https://img.shields.io/badge/npx_skills-add-green)](https://github.com/vercel-labs/skills)
  5. Two [Claude Code](https://docs.anthropic.com/en/docs/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.
  6. ## How It Works
  7. ```
  8. Documents / Code Obsidian Quiz Session
  9. ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
  10. │ PDF, MD, HTML, │ /tutor │ StudyVault/ │ /tutor │ 4 questions per │
  11. │ EPUB, source │──setup──▶ │ structured │────────▶ │ round, graded, │
  12. │ code projects │ │ interlinked │ │ concept tracking │
  13. └──────────────────┘ │ notes + MOC │ └────────┬─────────┘
  14. └──────────────────┘ │
  15. ▲ │
  16. └─────── progress updates ────┘
  17. ```
  18. ## Skills Overview
  19. | Skill | Command | Purpose | Input | Output |
  20. |-------|---------|---------|-------|--------|
  21. | **tutor-setup** | `/tutor-setup` | Generate a StudyVault | Documents or source code | Obsidian vault with notes, dashboards, practice questions |
  22. | **tutor** | `/tutor` | Interactive quiz tutor | An existing StudyVault | Quiz sessions with concept-level progress tracking |
  23. ## Quick Start
  24. ### One-line install (recommended)
  25. ```bash
  26. npx skills add RoundTable02/tutor-skills
  27. ```
  28. > Requires [npx skills](https://github.com/vercel-labs/skills) — works with Claude Code, Cursor, Windsurf, and more.
  29. ### Manual install
  30. ```bash
  31. git clone https://github.com/RoundTable02/tutor-skills.git
  32. cd tutor-skills
  33. ./install.sh
  34. ```
  35. ### Step 1: Generate a StudyVault
  36. ```bash
  37. cd ~/study-materials/ # or any source code project
  38. claude
  39. > /tutor-setup
  40. ```
  41. ### Step 2: Start Quizzing
  42. ```bash
  43. claude
  44. > /tutor
  45. ```
  46. ---
  47. ## tutor-setup
  48. Transforms knowledge sources into a structured Obsidian StudyVault. Mode is auto-detected:
  49. | Marker Found | Mode |
  50. |---|---|
  51. | `package.json`, `pom.xml`, `build.gradle`, `Cargo.toml`, `go.mod`, etc. | Codebase Mode |
  52. | No project markers | Document Mode |
  53. ### Document Mode
  54. Turns PDFs, text files, web pages, and other sources into comprehensive study notes.
  55. - Auto-scans working directory for source files (PDF, TXT, MD, HTML, EPUB)
  56. - Extracts and analyzes content with verified source mapping
  57. - Generates concept notes with comparison tables, ASCII diagrams, and exam patterns
  58. - Creates practice questions with hidden answers (active recall via fold callouts)
  59. - Builds a dashboard with Map of Content (MOC), Quick Reference, and Exam Traps
  60. - Full interlinking with `[[wiki-links]]` across all notes
  61. **Phases**
  62. | Phase | Name | Description |
  63. |-------|------|-------------|
  64. | D1 | Source Discovery | Scan, extract, and verify source content mapping |
  65. | D2 | Content Analysis | Build topic hierarchy and dependency map |
  66. | D3 | Tag Standard | Define English kebab-case tag registry |
  67. | D4 | Vault Structure | Create numbered folders per topic |
  68. | D5 | Dashboard | MOC, Quick Reference, Exam Traps |
  69. | D6 | Concept Notes | Structured notes with tables, diagrams, callouts |
  70. | D7 | Practice Questions | Active recall with fold callouts (8+ per topic) |
  71. | D8 | Interlinking | Cross-reference all notes with wiki-links |
  72. | D9 | Self-Review | Verify against quality checklist |
  73. **Generated structure**
  74. ```
  75. StudyVault/
  76. 00-Dashboard/ # MOC + Quick Reference + Exam Traps
  77. 01-<Topic1>/ # Concept notes + practice questions
  78. 02-<Topic2>/
  79. ...
  80. ```
  81. ### Codebase Mode
  82. Generates a new-developer onboarding vault from a source code project.
  83. - Auto-detects tech stack, architecture patterns, and module boundaries
  84. - Traces request flows and data flows end-to-end
  85. - Creates per-module notes with key files, public interfaces, and dependency maps
  86. - Generates onboarding exercises (code reading, configuration, debugging, extension)
  87. - Builds a dashboard with architecture overview, module map, API surface, and getting started guide
  88. **Phases**
  89. | Phase | Name | Description |
  90. |-------|------|-------------|
  91. | C1 | Project Exploration | Scan files, detect tech stack, map layout |
  92. | C2 | Architecture Analysis | Identify patterns, trace flows, map modules |
  93. | C3 | Tag Standard | Define `#arch-*`, `#module-*`, `#pattern-*` registry |
  94. | C4 | Vault Structure | Create dashboard + per-module folders |
  95. | C5 | Dashboard | MOC with module map, API surface, getting started |
  96. | C6 | Module Notes | Purpose, key files, interface, flow, dependencies |
  97. | C7 | Exercises | Code reading, config, debugging, extension tasks |
  98. | C8 | Interlinking | Cross-link all modules and exercises |
  99. | C9 | Self-Review | Verify against quality checklist |
  100. **Generated structure**
  101. ```
  102. StudyVault/
  103. 00-Dashboard/ # MOC + Quick Reference + Getting Started
  104. 01-Architecture/ # System overview, request flow, data flow
  105. 02-<Module1>/ # Per-module notes
  106. 03-<Module2>/
  107. ...
  108. NN-DevOps/ # Build, deploy, CI/CD
  109. NN+1-Exercises/ # Onboarding exercises
  110. ```
  111. ---
  112. ## tutor
  113. Interactive quiz tutor that tracks what you know and don't know at the **concept level**. Works with any StudyVault generated by `tutor-setup`.
  114. ### Session Types
  115. | Type | When Available | Focus |
  116. |------|----------------|-------|
  117. | Diagnostic | Unmeasured areas (⬜) exist | Broad assessment of new areas |
  118. | Drill weak areas | Weak areas (🟥/🟨) exist | Targeted practice on struggles |
  119. | Choose a section | Always | Study any area on demand |
  120. | Hard-mode review | All areas 🟩/🟦 | Challenge mastered material |
  121. ### Quiz Flow
  122. 1. Detects your StudyVault and reads the learning dashboard
  123. 2. Presents session options based on your current proficiency
  124. 3. Delivers 4 questions per round (4 options each, zero hints)
  125. 4. Grades answers and explains mistakes
  126. 5. Updates concept files and dashboard automatically
  127. ### Progress Tracking
  128. Proficiency is tracked per area with emoji badges:
  129. | Badge | Level | Rate |
  130. |-------|-------|------|
  131. | 🟥 | Weak | 0–39% |
  132. | 🟨 | Fair | 40–69% |
  133. | 🟩 | Good | 70–89% |
  134. | 🟦 | Mastered | 90–100% |
  135. | ⬜ | Unmeasured | No data |
  136. 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.
  137. ---
  138. ## The Learning Cycle
  139. ```
  140. ┌────────────────────────────┐
  141. │ /tutor-setup │
  142. │ Generate StudyVault │
  143. └──────────┬─────────────────┘
  144. │
  145. ▼
  146. ┌────────────────────────────┐
  147. │ Read & review notes │
  148. │ in Obsidian │
  149. └──────────┬─────────────────┘
  150. │
  151. ▼
  152. ┌────────────────────────────┐
  153. │ /tutor │
  154. │ Take diagnostic quiz │◀──────────┐
  155. └──────────┬─────────────────┘ │
  156. │ │
  157. ▼ │
  158. ┌────────────────────────────┐ │
  159. │ Review weak areas │ │
  160. │ in Obsidian │ │
  161. └──────────┬─────────────────┘ │
  162. │ │
  163. ▼ │
  164. ┌────────────────────────────┐ │
  165. │ /tutor │ │
  166. │ Drill weak concepts │───────────┘
  167. └────────────────────────────┘
  168. ```
  169. ## Requirements
  170. - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and configured
  171. - [Obsidian](https://obsidian.md/) (recommended) to open and navigate the generated vault
  172. ## Repository Structure
  173. ```
  174. tutor-skill/
  175. ├── skills/
  176. │ ├── tutor-setup/ # Vault generation skill
  177. │ │ ├── SKILL.md
  178. │ │ └── references/
  179. │ │ ├── templates.md
  180. │ │ ├── codebase-workflow.md
  181. │ │ ├── quality-checklist.md
  182. │ │ └── codebase-templates.md
  183. │ └── tutor/ # Interactive quiz skill
  184. │ ├── SKILL.md
  185. │ └── references/
  186. │ └── quiz-rules.md
  187. ├── examples/
  188. ├── install.sh
  189. ├── uninstall.sh
  190. ├── README.md
  191. └── LICENSE
  192. ```
  193. ## Uninstall
  194. ```bash
  195. ./uninstall.sh
  196. ```
  197. Or manually:
  198. ```bash
  199. rm -rf ~/.claude/skills/tutor-setup
  200. rm -rf ~/.claude/skills/tutor
  201. ```
  202. ## License
  203. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.