# bevibing/tutor-skills architecture

> Architecture diagram of the GitHub repository bevibing/tutor-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bevibing/tutor-skills
- Repository: https://github.com/bevibing/tutor-skills

## Overview

This repository provides two Claude Code skills: tutor-setup turns documents or code projects into an Obsidian StudyVault, and tutor uses that vault for interactive quizzes and concept-level progress tracking. The graph follows the documented setup and tutoring workflows, including document and codebase modes. Source excerpts were unavailable, so relationships are based on README statements; implementation details beyond those statements are not inferred.

Main entry points: [`skills/tutor-setup/SKILL.md`](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/SKILL.md) (Setup skill), [`skills/tutor/SKILL.md`](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/SKILL.md) (Tutor skill), [`skills/tutor-setup/references/codebase-workflow.md`](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/codebase-workflow.md) (Source discovery), [`skills/tutor-setup/references/templates.md`](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/templates.md) (Vault templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Vault setup"]
  node_setup_skill["Setup skill<br/>[SKILL.md]"]
  node_source_discovery["Source discovery"]
  node_document_analysis["Document analysis<br/>[SKILL.md]"]
  node_codebase_analysis["Codebase analysis"]
  node_vault_templates["Vault templates<br/>[templates.md]"]
  node_quality_review["Quality review"]
end

subgraph group_vault["StudyVault content"]
  node_studyvault["StudyVault"]
  node_dashboard["Learning dashboard"]
  node_concept_notes["Concept notes"]
  node_practice_questions["Practice questions"]
end

subgraph group_tutoring["Quiz tutoring"]
  node_tutor_skill["Tutor skill<br/>[SKILL.md]"]
  node_quiz_rules["Quiz rules<br/>[quiz-rules.md]"]
  node_quiz_session["Quiz session<br/>[SKILL.md]"]
  node_progress["Concept progress<br/>[SKILL.md]"]
end

node_learner(("Learner"))
node_sources["Study sources"]
node_obsidian["Obsidian"]

node_learner -->|"invokes setup"| node_setup_skill
node_sources -->|"provides material"| node_setup_skill
node_setup_skill -->|"scans sources"| node_source_discovery
node_setup_skill -->|"analyzes documents"| node_document_analysis
node_setup_skill -->|"analyzes codebase"| node_codebase_analysis
node_setup_skill -.->|"uses templates"| node_vault_templates
node_setup_skill -->|"reviews output"| node_quality_review
node_setup_skill -->|"generates vault"| node_studyvault
node_studyvault -->|"contains dashboard"| node_dashboard
node_studyvault -->|"contains notes"| node_concept_notes
node_studyvault -->|"contains questions"| node_practice_questions
node_learner -->|"invokes tutor"| node_tutor_skill
node_tutor_skill -->|"reads progress"| node_dashboard
node_tutor_skill -.->|"uses quiz rules"| node_quiz_rules
node_tutor_skill -->|"starts session"| node_quiz_session
node_quiz_session -->|"selects concepts"| node_concept_notes
node_quiz_session -->|"updates tracking"| node_progress
node_progress -->|"updates dashboard"| node_dashboard
node_learner -->|"answers questions"| node_quiz_session
node_studyvault -->|"opened in"| node_obsidian

click node_setup_skill "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/SKILL.md"
click node_source_discovery "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/codebase-workflow.md"
click node_document_analysis "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/SKILL.md"
click node_codebase_analysis "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/codebase-workflow.md"
click node_vault_templates "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/templates.md"
click node_quality_review "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/quality-checklist.md"
click node_tutor_skill "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/SKILL.md"
click node_quiz_rules "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/references/quiz-rules.md"
click node_quiz_session "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/SKILL.md"
click node_progress "https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_setup_skill,node_source_discovery,node_document_analysis,node_codebase_analysis,node_vault_templates,node_quality_review toneBlue
class node_studyvault,node_dashboard,node_concept_notes,node_practice_questions toneAmber
class node_tutor_skill,node_quiz_rules,node_quiz_session,node_progress toneMint
class node_learner,node_sources,node_obsidian toneIndigo
```

## Components

### Vault setup

- [Setup skill](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/SKILL.md): `skills/tutor-setup/SKILL.md`
- [Source discovery](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/codebase-workflow.md): `skills/tutor-setup/references/codebase-workflow.md`
- [Document analysis](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/SKILL.md): `skills/tutor-setup/SKILL.md`
- [Codebase analysis](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/codebase-workflow.md): `skills/tutor-setup/references/codebase-workflow.md`
- [Vault templates](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/templates.md): `skills/tutor-setup/references/templates.md`
- [Quality review](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor-setup/references/quality-checklist.md): `skills/tutor-setup/references/quality-checklist.md`

### StudyVault content

- **StudyVault**
- **Learning dashboard**
- **Concept notes**
- **Practice questions**

### Quiz tutoring

- [Tutor skill](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/SKILL.md): `skills/tutor/SKILL.md`
- [Quiz rules](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/references/quiz-rules.md): `skills/tutor/references/quiz-rules.md`
- [Quiz session](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/SKILL.md): `skills/tutor/SKILL.md`
- [Concept progress](https://github.com/bevibing/tutor-skills/blob/main/skills/tutor/SKILL.md): `skills/tutor/SKILL.md`

### Other components

- **Learner**
- **Study sources**
- **Obsidian**

## Connections

- Learner → Setup skill: invokes setup (evidence: `README.md`)
- Study sources → Setup skill: provides material (evidence: `README.md`)
- Setup skill → Source discovery: scans sources (evidence: `README.md`)
- Setup skill → Document analysis: analyzes documents (evidence: `README.md`)
- Setup skill → Codebase analysis: analyzes codebase (evidence: `README.md`)
- Setup skill → Vault templates: uses templates
- Setup skill → Quality review: reviews output (evidence: `README.md`)
- Setup skill → StudyVault: generates vault (evidence: `README.md`)
- StudyVault → Learning dashboard: contains dashboard (evidence: `README.md`)
- StudyVault → Concept notes: contains notes (evidence: `README.md`)
- StudyVault → Practice questions: contains questions (evidence: `README.md`)
- Learner → Tutor skill: invokes tutor (evidence: `README.md`)
- Tutor skill → Learning dashboard: reads progress (evidence: `README.md`)
- Tutor skill → Quiz rules: uses quiz rules
- Tutor skill → Quiz session: starts session (evidence: `README.md`)
- Quiz session → Concept notes: selects concepts (evidence: `README.md`)
- Quiz session → Concept progress: updates tracking (evidence: `README.md`)
- Concept progress → Learning dashboard: updates dashboard (evidence: `README.md`)
- Learner → Quiz session: answers questions (evidence: `README.md`)
- StudyVault → Obsidian: opened in (evidence: `README.md`)