PluginBench
Skill
Pass
Audit score 90

obsidian-vault

mattpocock/skills

Search, create, and manage notes in your Obsidian vault with wikilinks and index organization.

What is obsidian-vault?

Interact with an Obsidian vault stored at `/mnt/d/Obsidian Vault/AI Research/` to search, create, and organize markdown notes. Use this when you need to find existing notes, create new ones with proper linking, or discover related content through wikilinks and index notes.

  • Search notes by filename or content using grep and find commands
  • Create new notes in Title Case with wikilink references to related notes
  • Find backlinks and related notes by searching for wikilink references
  • Locate index notes that aggregate related topics
  • Organize notes using wikilinks instead of folder hierarchies
  • Add notes to numbered sequences with hierarchical numbering

How to install obsidian-vault

npx skills add https://github.com/mattpocock/skills --skill obsidian-vault
Prerequisites
  • Access to Obsidian vault at `/mnt/d/Obsidian Vault/AI Research/`
  • Ability to execute bash commands (find, grep)
Claude Code
Cursor
Windsurf
Cline

How to use obsidian-vault

  1. 1.Use find or grep commands to search for existing notes by filename or content
  2. 2.Create new notes using Title Case naming convention
  3. 3.Add wikilink references `[[Note Title]]` to related notes at the bottom of new notes
  4. 4.Link new notes to existing index notes or create index entries if starting a new topic
  5. 5.Use grep to find backlinks and discover how notes are connected

Use cases

Good for
  • Finding research notes on a specific topic by keyword search
  • Creating a new learning note and linking it to related existing notes
  • Discovering all notes that reference a particular concept via backlinks
  • Building or updating index notes that aggregate related topics
  • Organizing new notes into a flat vault structure using links
Who it's for
  • Researchers maintaining a knowledge base
  • Students organizing learning materials
  • Knowledge workers building a personal wiki
  • Anyone using Obsidian for note-taking and knowledge management

obsidian-vault FAQ

How do I search for a note?

Use `find "/mnt/d/Obsidian Vault/AI Research/" -name "*.md" | grep -i "keyword"` to search by filename, or `grep -rl "keyword" "/mnt/d/Obsidian Vault/AI Research/" --include="*.md"` to search by content.

What naming convention should I use for new notes?

Use Title Case for all note filenames (e.g., `Ralph Wiggum Index.md`, `Skills Index.md`). Index notes should include "Index" in the name.

How do I link notes together?

Use Obsidian wikilink syntax `[[Note Title]]` at the bottom of notes to reference related or dependent notes. Index notes are just lists of wikilinks.

How do I find all notes that reference a specific note?

Use `grep -rl "\[\[Note Title\]\]" "/mnt/d/Obsidian Vault/AI Research/"` to find all backlinks to a note.

Should I use folders to organize notes?

No. The vault uses a flat structure at root level. Organize notes using wikilinks and index notes instead of folders.

Full instructions (SKILL.md)

Source of truth, from mattpocock/skills.


name: obsidian-vault description: 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.

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

# 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:

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

Find index notes

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