obsidian-study-vault-builder（Obsidian study vault 构建器）

Obsidian Study Vault Builder

Comprehensive patterns for building exam-ready study vaults in Obsidian

Build structured, mobile-compatible academic study vaults with systematic error prevention, quality assurance, and efficiency patterns extracted from real-world projects.

⚠️ IMPORTANT: See REFERENCE.md for complete battle-tested patterns from 828KB/37-file vault projects.

When to Use This Skill

Invoke when building academic study materials in Obsidian for:

• Final exam preparation (any subject)
• Course knowledge organization (CS, medicine, business, law, etc.)
• Self-study material structuring
• Technical documentation vaults
• Large-scale study projects (10+ files, 200KB+)

Works across all subjects:

• Computer Science (algorithms, data structures, systems)
• Medicine (anatomy, pharmacology, pathology)
• Business (finance, marketing, operations)
• STEM (physics, chemistry, engineering)
• Humanities (history, literature, philosophy)

Core Methodology

Checkpoint-Based Workflow (Critical)

Never generate all chapters upfront. Use progressive validation:

1. Chapter 1 Generation → STOP
2. User Review → Approve format, structure, quality
3. Chapters 2-N → Continue with validated pattern
4. Final QA → Systematic verification

Why this matters:

• Catches format issues before they multiply across 30+ files
• Validates approach matches user needs early
• Adjusts course when cheap (Chapter 1) vs expensive (Chapter 8)
• Prevents 5+ hours of rework

Time breakdown: Chapter 1 (~30 min) → Review (~15 min) → Remaining (~90 min) → QA (~30 min) = 2.5 hours vs 80 hours manual

Memory File Hierarchy

Three-level context structure (see REFERENCE.md for details):

• Level 1: Root vault (CLAUDE.md)
• Level 2: Subject folder (School/CLAUDE.md)
• Level 3: Course project (School/algorithms/CLAUDE.md)

Universal Obsidian Features (Mobile-First)

✅ Use only: Mermaid diagrams, LaTeX math, standard callouts, internal links, tables, code blocks ❌ Never use: Dataview queries, custom callouts, plugins

See REFERENCE.md for complete patterns.

Error Pattern Recognition (8 Patterns)

Pattern 1: Unicode Corruption in Mermaid

• Symptom: Diagrams fail to render
• Diagnosis: grep -r "≤\|≥\|∞\|∈\|≠\|→" *.md
• Fix: Replace with ASCII (<=, >=, infinity, in, !=, ->)

Pattern 2: Broken Tables (LaTeX Pipes)

• Diagnosis: grep -r "| \$.*|.*\$" *.md
• Fix: Escape pipes: | → \|

Pattern 3: Missing Collapsible Solutions

• Diagnosis: grep -A 5 "## Problem" practice-problems.md | grep -v "\[!example\]-"
• Fix: Use > [!example]- Solution

Pattern 4-8: See REFERENCE.md

• Inconsistent navigation
• Missing learning objectives
• Inconsistent TOC
• Empty core concepts
• Broken cross-references

Complete systematic fix approach in REFERENCE.md.

Content Quality Patterns

Applied Understanding (Not Memorization)

Good questions:

• "Design [system] for [context]. Current [problem]. Describe solution to achieve [goal]. Analyze trade-offs and justify."

Adapts to subject:

• CS: Algorithm design scenarios
• Medicine: Case-based diagnosis
• Business: Strategic analysis
• Physics: Experimental design

Comprehensive Coverage

Every topic from source materials must appear. Validation: cross-reference source outline with vault TOC.

Cross-Reference Pattern

Link related concepts everywhere with [[links]].

See REFERENCE.md for complete examples.

Standard Vault Structure

course-name/
├── 00-overview/          # Course map, schedule, strategy
├── 01-chapter-name/      # Core concepts, quick-ref, practice
├── cross-chapter/        # Comparisons, patterns, catalog
└── mock-exams/           # Practice tests + solutions

Quality Assurance (Summary)

Before marking complete:

• Structural consistency (navigation, objectives, TOC)
• Content completeness (all topics covered)
• Format correctness (no Unicode in Mermaid, LaTeX pipes escaped)
• Mobile compatibility (no plugins)
• Assessment alignment (practice matches exam style)

See REFERENCE.md for complete 50+ item checklist.

Common Anti-Patterns

1. "I'll Fix It Later" → Fix immediately
2. Generating Without Checkpoints → Chapter 1 → Review → Continue
3. Forgetting Mobile Users → Universal features only
4. Surface-Level Practice → Scenario-based with reasoning

Success Metrics

Typical project:

• Files: 30-40
• Size: 600-900KB
• Coverage: 100% of source topics
• Rendering errors: 0
• Time saved: 80+ hours
• Practice problems: 80-100
• Mock exams: 2-3

Integration Patterns

Task Agents for Large Analysis

For 100+ pages of materials, use Task tool with subagent_type=Explore.

Git Workflow

git commit -m "Initial vault structure"
git commit -m "Complete Chapter 1 (checkpoint)"
git commit -m "Complete: Study vault (37 files, 828KB)"

CLI Integration

Obsidian CLI (v1.12+) complements the Write tool for specific operations. Requires Obsidian app running.

When to Use CLI vs Write Tool

Post-Build Verification

Run after vault generation to catch issues:

obsidian.com files folder=<course> total        # Verify file count matches expected
obsidian.com tags counts                        # Verify tags are populated
obsidian.com unresolved                         # Find broken [[wiki-links]]
obsidian.com orphans                            # Find files with no incoming links
obsidian.com deadends                           # Find files with no outgoing links
obsidian.com search query="TODO"                # Catch unfinished placeholders

Frontmatter Operations

Use CLI instead of manual YAML editing for property manipulation:

obsidian.com property:set name=tags value="[exam-prep,chapter-1]" type=list path=<file>
obsidian.com property:set name=status value=draft path=<file>
obsidian.com property:read name=tags path=<file>

Incremental Updates

For adding content to existing vault files without full rewrites:

obsidian.com append path=<file> content="## New Section\n..."
obsidian.com daily:append content="- [ ] Review chapter 3"

Sync Awareness

Check sync state before/after large operations:

obsidian.com sync:status    # Verify sync is not paused before starting vault build

Additional Resources

See REFERENCE.md for:

• Complete Obsidian universal features documentation
• Detailed Mermaid diagram patterns (flowcharts, mind maps, graphs, recursion trees)
• Detailed LaTeX notation patterns with table escaping
• Collapsible solution complete templates
• Full 50+ item quality assurance checklist with examples
• Subject-specific adaptation examples (CS, medicine, business, humanities)
• Complete step-by-step workflow example
• Error pattern recognition (all 8 patterns with examples)
• Systematic fix approach (5-step process)
• Communication patterns that work
• Anti-patterns to avoid
• Time investment breakdowns

Battle-tested on:

• 37-file academic vaults
• 828KB comprehensive coverage
• Multiple subjects (CS, engineering, business)
• Zero rendering errors achieved
• ~80 hours manual work saved per project

Ready to build exam-ready study vaults across any subject with systematic quality assurance.