Agent skill

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

Stars 111,310
Forks 9,758

Install this agent skill to your Project

npx add-skill https://github.com/mattpocock/skills/tree/main/skills/personal/obsidian-vault

SKILL.md

Obsidian Vault

Vault location

/mnt/d/Obsidian Vault/AI Research/

Mostly flat at root level.

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

bash
# Search by filename
find "/mnt/d/Obsidian Vault/AI Research/" -name "*.md" | grep -i "keyword"

# Search by content
grep -rl "keyword" "/mnt/d/Obsidian Vault/AI Research/" --include="*.md"

Or use Grep/Glob tools directly on the vault path.

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:

bash
grep -rl "\\[\\[Note Title\\]\\]" "/mnt/d/Obsidian Vault/AI Research/"

Find index notes

bash
find "/mnt/d/Obsidian Vault/AI Research/" -name "*Index*"

Didn't find tool you were looking for?

Be as detailed as possible for better results