Obsidian Brain

Obsidian Brain — Vault Knowledge as Context

Use vault notes as conversational context and archive session learnings as Zettelkasten notes.

Skill Boundary

| Intent | Skill | |--------|-------| | Create, edit, move, search notes | obsidian | | Use vault knowledge as context | obsidian-brain ✅ | | Archive session learnings | /obsidian-archive command | | Explicitly load vault context | /brain command |

Vault Path Resolution

Resolve once per session, cache for reuse:

1. User override: ~/.claude/obsidian-brain/config.json → vaultPath
2. obsidian-cli: obsidian-cli print-default --path-only
3. Obsidian app config: ~/Library/Application Support/obsidian/obsidian.json
4. Ask user: "Obsidian vault 경로를 알려주세요"

If vault path is invalid, clear config and re-resolve. See references/vault-setup.md for details.

Context Loading Workflow

When the user asks to reference their notes:

1. Parse query — extract topic keywords from the user's request
2. MOC scan — Grep 2-maps/*.md for keywords, read top 3 matching MOCs
3. Note retrieval — extract [[wikilinks]] from MOCs, read up to 5 linked notes
4. Fallback search — if MOC scan finds nothing, Grep 1-zettelkasten/ and 0-inbox/ directly for keywords (catches orphan notes not linked to any MOC)
5. Context budget — stay within 15,000 characters total:

• 3 MOCs × ~1,000 chars = ~3,000
• 5 notes × ~2,000 chars = ~10,000
• Remaining ~2,000 for relationship context

1. Present — summarize what was found, answer the user's question using note content

If No Notes Found

이 주제에 대한 노트를 찾지 못했습니다.
관련 키워드: [searched terms]

Cold Start (Empty Vault)

If 2-maps/ is empty or missing, inform the user:

vault에 아직 노트가 없습니다. /obsidian-archive 로 학습 내용을 저장해보세요.

Archive Workflow

The /obsidian-archive command handles learning extraction. It follows:

1. Session analysis — Progressive Summarization으로 학습 추출
2. MOC scan — 기존 노트와 관련성 검색
3. Duplicate detection — 중복 노트 확인
4. Draft generation — 사용자 승인/수정 루프
5. Save — 0-inbox/에 저장, MOC 업데이트

Full workflow details in references/archive-workflow.md. Note and MOC templates in references/templates.md.

Iron Rules

1. Never auto-save — always present drafts for user approval
2. Respect context budget — never exceed 15,000 chars in MOC scan
3. Atomic notes only — one idea per note, declarative English title
4. Korean content — note body is always in Korean
5. No forced archival — if no learnings found, say so honestly
6. Vault path first — resolve vault path before any file operation
7. Grep over glob — use Grep to search inside MOCs, not read-all

References Loading Guide

| Situation | Load | |-----------|------| | First run, vault setup needed | references/vault-setup.md | | Creating notes or MOCs | references/templates.md | | Running /obsidian-archive | references/archive-workflow.md |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hamsurang
• Source: hamsurang/kit
• License: MIT

Install and usage instructions live in the source repository linked above.