obsidian-vault-agent

Obsidian Vault Agent

A Claude Code plugin that gives your Obsidian vault specialized skills — process entire books, take notes on full courses, create presentations, research topics, and build a knowledge base that actually helps you think.

• Install
• Skills — Learn · Think · Research · Create
• Why Obsidian + Agent?
• How it works

Install

# Add the marketplace (one-time)
claude plugin marketplace add tuan3w/obsidian-vault-agent

# Install into your vault
claude plugin install obsidian-vault-agent --scope project

# Scaffold a new vault
mkdir my-vault && cd my-vault
claude
/init    # creates vault structure, templates, hooks, MCP config

Requirements: Claude Code, uv (brew install uv), Obsidian

Python and Node dependencies are managed automatically — uv run (Python) and npx (Node) handle installation on first use. No manual pip install or npm install needed.

Tip: Use Claudian to run Claude Code directly inside Obsidian.

Skills

Learn

/course — Drop a course URL. The agent crawls the lecture schedule, processes each lecture in parallel (transcripts + slides), and creates structured notes for every session. One command, a full course of connected notes.

/course take notes on this course https://cs231n.stanford.edu/

/book-analyzer — Give it an EPUB or PDF. Extracts chapters, analyzes each in parallel with separate agents, synthesizes across the entire book. Key concepts become atomic notes linked to your vault.

/book-analyzer process this book ~/Downloads/thinking-fast-and-slow.epub

/lecture — Local video files → transcribed with mlx-whisper, slide frames extracted with timestamps, structured into lecture notes with embedded screenshots. Any language.

/lecture take notes on this lecture ~/recordings/mit-6s191-lecture12.mp4

/youtube — Paste a link. Synthesizes the transcript into a thematic note (not a dump), identifies concepts worth extracting.

/youtube check out this talk https://www.youtube.com/watch?v=SjhIlw3Iffs

Think

/process — The core learning skill. Open a source note and run /process. The agent asks you retrieval questions before showing content (generation effect — writing from memory beats copying), identifies concepts to extract, suggests cross-domain connections, creates linked notes. You do the thinking. The agent structures it.

/recall — Not flashcards. Interleaves domains aggressively — ML + psychology + finance in one session. Finds two unlinked notes from different domains sharing the same concept and asks: do you see the link?

/synthesize — Exhausts your vault's knowledge on a topic across all domains, surfaces contradictions you haven't noticed, forces abstraction, asks uncomfortable questions anchored in your own evidence.

/synthesize what do I know about scaling laws? connect ideas across my vault

Research

/research — Multi-pass: decomposes your question into sub-queries, searches web + your vault, detects gaps, runs follow-ups. Knows what your vault already covers so it doesn't repeat.

/research how do scaling laws apply to reinforcement learning?

/deep-research — When /research isn't enough. Discovers perspectives before searching (not just sub-questions), hits 4 source types in parallel (web, academic papers, Reddit, vault), then loops through exploration → critique rounds until contradictions are resolved and gaps are filled. Produces a note with fact-level citations and a confidence map.

/deep-research how are foundation models changing drug discovery? --deep

/paper-discover — Searches Semantic Scholar, ranks by vault relevance (not just citations). Finds papers similar to ones you have, discovers gaps in your reading.

/paper-discover find papers about mechanistic interpretability related to what I've read

Create

/slide-maker — Not generic AI slides. Asks about your audience, picks color palettes that fit the topic, generates insight headlines (not labels), enforces real design principles.

/slide-maker make a presentation about attention mechanisms for ML engineers

/vault-graph — Analyzes your wikilinks as a directed graph — PageRank, bridge concepts between isolated domains, orphan detection. Tells you which notes to create next.

Why Obsidian + Agent?