obsidian-vault

Obsidian Vault

Vault Location

Resolve the vault path in this order:

1. The OBSIDIAN_VAULT environment variable.
2. A path provided in the user's message.
3. A path written in ~/.nous/config.json under the key obsidianVault.

If none of these is set, ask the user for the vault path before doing any reads or writes. Do not assume a default.

Naming Conventions

• Index notes: aggregate related topics (e.g., Ralph Wiggum Index.md, Skills Index.md, RAG Index.md)
• Title case for all note names
• No folders for organization - use links and index notes instead

Linking

• Use Obsidian [[wikilinks]] syntax: [[Note Title]]
• Notes link to dependencies/related notes at the bottom
• Index notes are just lists of [[wikilinks]]

Workflows

Search For Notes

Use Grep/Glob tools directly on the vault path when available.

# Search by filename
find "$OBSIDIAN_VAULT" -name "*.md" | grep -i "keyword"

# Search by content
grep -rl "keyword" "$OBSIDIAN_VAULT" --include="*.md"

Create A New Note

1. Use Title Case for filename.
2. Write content as a unit of learning per vault rules.
3. Add [[wikilinks]] to related notes at the bottom.
4. If part of a numbered sequence, use the hierarchical numbering scheme.

Find Related Notes

Search for [[Note Title]] across the vault to find backlinks:

grep -rl "\\[\\[Note Title\\]\\]" "$OBSIDIAN_VAULT"

Find Index Notes

find "$OBSIDIAN_VAULT" -name "*Index*"

Output Contract

When using this skill, report the notes found, created, or updated. Include exact note paths and any wikilinks added.