Obsidian Vault
Search, create, and link Obsidian notes with wikilinks and index pages so your agent maintains a flat, linked knowledge base while you build.
Overview
Obsidian Vault is an agent skill most often used in Build (also Idea research) that searches, creates, and organizes Obsidian markdown notes with wikilinks and index notes.
Install
npx skills add https://github.com/mattpocock/skills --skill obsidian-vaultWhat is this skill?
- Search vault by filename find and by content grep on a configured vault root path
- Create notes in Title Case with wikilinks to related notes and optional index aggregators
- Flat vault layout—organization via links and index notes, not folder trees
- Backlink discovery by grepping for [[Note Title]] across the vault
- Documents hierarchical numbering for sequenced note series when applicable
Adoption & trust: 26.6k installs on skills.sh; 121k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your research and specs live in Obsidian but your agent cannot reliably search, create, or link notes in your vault.
Who is it for?
Solo builders who already use Obsidian as a flat, link-first knowledge base and want the agent to read and write markdown there.
Skip if: Teams standardized on Notion or Google Docs only, or workflows that forbid local filesystem access to personal note paths.
When should I use this skill?
User wants to find, create, or organize notes in Obsidian, including search, wikilinks, and index notes.
What do I get? / Deliverables
Your agent follows vault naming and linking conventions to produce searchable, backlink-friendly notes that stay connected via index and wikilink patterns.
- New or updated .md notes with Title Case names
- Wikilink sections and optional index note updates
- Search results from filename or content queries
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Build/docs is the canonical shelf because the skill operationalizes note creation, search, and linking as documentation and learning units during product work. docs fits structured notes, index pages, and wikilink graphs that support specs and research artifacts—not app runtime code.
Where it fits
Create a Title Case implementation note and link it from your Skills Index.md.
Grep the vault for prior competitor notes before starting a new discovery doc.
Append learnings from an incident postmortem with wikilinks to related runbooks.
How it compares
Use this filesystem-linked Obsidian workflow instead of dumping long-term knowledge only into ephemeral chat threads.
Common Questions / FAQ
Who is obsidian-vault for?
It is for indie builders and researchers who keep specs and learning notes in Obsidian and want their agent to search, create, and wikilink without manual copy-paste.
When should I use obsidian-vault?
Use it during Build/docs when capturing implementation learnings, during Idea/research when filing competitor or audience notes, and anytime the user asks to find, create, or organize notes in Obsidian.
Is obsidian-vault safe to install?
The skill implies read/write access to your vault directory via shell and grep; review the Security Audits panel on this Prism page and point the vault path only at data you are willing to expose to the agent.
SKILL.md
READMESKILL.md - Obsidian Vault
# 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*" ```