Obsidian Vault
- 172k installs
- 192k repo stars
- Updated July 27, 2026
- mattpocock/skills
obsidian-vault is a Claude Code skill that manages a flat, folder-free Obsidian vault - searching notes with find/grep, creating Title Case notes as units of learning, and organizing via [[wikilinks]] and index notes.
About
obsidian-vault teaches the agent to search, create, and manage notes in a specific Obsidian vault (an AI Research vault at /mnt/d/Obsidian Vault/AI Research/). The vault is mostly flat with no folders: organization happens through [[wikilinks]] and index notes, which are plain lists of wikilinks aggregating a topic. Note names use Title Case, related notes are linked at the bottom, and new notes are written as a unit of learning. Workflows cover searching by filename (find) or content (grep -rl), finding backlinks by grepping for [[Note Title]], locating index notes, and creating notes that follow the naming and linking conventions. Note the vault path is hardcoded to the author's machine, so developers adopting it should adjust the path and treat it as a template for link-based personal knowledge management.
- Encodes the vault's conventions: Title Case filenames, a mostly flat root, and no folders - organization via links and i
- Uses Obsidian [[wikilinks]] with related-note links placed at the bottom of each note
- Index notes (e.g. Skills Index.md, RAG Index.md) are plain lists of wikilinks aggregating a topic
- Search workflows via find (filename), grep -rl (content), and grep for [[Note Title]] to discover backlinks
- New notes are written as a unit of learning per the vault's rules, with wikilinks to related notes appended
Obsidian Vault by the numbers
- 172,397 all-time installs (skills.sh)
- +25,267 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #29 of 3,301 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
obsidian-vault capabilities & compatibility
- Capabilities
- vault filename and content search · title case note creation · wikilink and backlink management · index note discovery
- Works with
- obsidian
- Use cases
- research · documentation · memory
- Runs
- Runs locally
- Pricing
- Free
What obsidian-vault says it does
No folders for organization - use links and index notes instead
Index notes are just lists of `[[wikilinks]]`
Write content as a unit of learning (per vault rules)
npx skills add https://github.com/mattpocock/skills --skill obsidian-vaultAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 172k |
|---|---|
| repo stars | ★ 192k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 27, 2026 |
| Repository | mattpocock/skills ↗ |
How do I get a coding agent to find, create, and correctly cross-link notes in my Obsidian vault without breaking its naming and linking conventions?
Search, create, and organize Markdown notes in an Obsidian vault using find/grep, [[wikilinks]], Title Case names, and index notes instead of folders.
Who is it for?
Developers keeping a link-based personal knowledge vault in Obsidian who want the agent to search, create, and cross-link notes following consistent flat-vault conventions.
Skip if: Skip it if you organize notes in folder hierarchies, use a different notes app, or expect it to work unmodified - the vault path is hardcoded to the author's setup.
When should I use this skill?
When the user wants to find, create, or organize notes in Obsidian.
What you get
New or updated Title Case Markdown notes in the vault with [[wikilinks]] to related notes at the bottom, plus updated index notes; searches return matching notes and backlinks.
- new or updated Markdown notes with wikilinks
- index notes aggregating related topics
By the numbers
- Vault uses mostly flat root layout with index note naming pattern like Skills Index.md.
Files
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*"Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.645k185kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.547k185k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.466kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).466kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.466kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.465kForks & variants (1)
Obsidian Vault has 1 known copy in the catalog totaling 1 installs. They canonicalize to this original listing.
- timothyvang - 1 installs
How it compares
Use instead of unstructured 'add a note' prompts - it encodes the vault's conventions (flat structure, wikilinks, index notes) so agent-created notes match human-created ones.
FAQ
How does obsidian-vault organize notes without folders?
The vault stays mostly flat at root; organization comes from [[wikilinks]] between notes and index notes (e.g. RAG Index.md) that are just lists of wikilinks aggregating a topic. Related notes are linked at the bottom of each note.
How does it find related or linked notes?
It greps the vault for [[Note Title]] to find backlinks, uses find on filenames for keyword lookup, grep -rl for content search, and a find on *Index* to list index notes.
Can I use this skill with my own vault?
The vault path is hardcoded to the author's machine (/mnt/d/Obsidian Vault/AI Research/), so you would edit the path and keep the conventions: Title Case names, wikilinks, index notes, no folders.
Is Obsidian Vault safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.