Back to skills

Agent Skill

Obsidian Vault

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.

MattpocockToolsShell

61K installs

mattpocock/skills

by Mattpocock

Score

8.8

/ 10

Installs

61K

Repo Stars

140.9K

Last Updated

4d ago

Fresh

Quality Ratio

97%

Description

Verified

Language

Shell

First Published

Mar 2026

Summary

The Obsidian Vault agent skill enables AI agents to search, create, and manage notes within an Obsidian vault, adhering to its specific naming and linking conventions. This skill is designed for individuals, researchers, or developers who use Obsidian as their primary personal knowledge management system and wish to leverage AI for note organization and retrieval. It is an emerging or highly specialized skill with limited adoption so far. It guides the agent to maintain a flat file structure, enforce Title Case for note names, and utilize `[[wikilinks]]` and dedicated index notes for content organization instead of folders. The skill provides clear instructions for searching notes by filename or content using specific shell commands, creating new notes formatted as units of learning, and identifying related or index notes. Its guidance is rooted in a specific vault structure and location, suggesting it may require initial configuration to match individual user setups.

Skill Definition

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*"

How to Use

Use in O-mega

Claude Code

npx skills add mattpocock/skills obsidian-vault
Obsidian Vault | Agent Skills | o-mega