obsidian-vault
mattpocock/skills
Search, create, and manage notes in your Obsidian vault with wikilinks and index organization.
What is obsidian-vault?
This skill enables you to search, create, and organize notes within an Obsidian vault using wikilinks and index notes. Use it when you need to find existing notes, create new ones, or maintain connections between related topics in your knowledge base.
- Search notes by filename or content using grep and find commands
- Create new notes following Title Case naming and wikilink conventions
- Link notes together using Obsidian [[wikilink]] syntax
- Find backlinks and related notes across the vault
- Locate and manage index notes that aggregate related topics
- Maintain a flat vault structure organized through links rather than folders
How to install obsidian-vault
npx skills add https://github.com/mattpocock/skills --skill obsidian-vault- Access to the Obsidian vault at /mnt/d/Obsidian Vault/AI Research/
- Familiarity with Obsidian wikilink syntax [[Note Title]]
- Basic understanding of grep and find commands for searching
How to use obsidian-vault
- 1.Decide whether you need to search for existing notes or create a new one
- 2.For searching: use find for filename matches or grep for content matches within the vault directory
- 3.For creating: write your note in Title Case, add content as a learning unit, and include [[wikilinks]] to related notes at the bottom
- 4.For finding related notes: search the vault for backlinks to your note using grep with the wikilink syntax
- 5.Check for relevant index notes using find with the *Index* pattern to see aggregated topics
Use cases
- Finding a specific note by keyword when you remember part of its title or content
- Creating a new research note and linking it to related existing notes
- Building an index note to aggregate all notes on a particular topic
- Discovering which notes reference a specific concept through backlink search
- Organizing a new area of knowledge by creating interconnected notes with proper wikilinks
- Knowledge workers maintaining a personal wiki or research vault
- Students organizing study notes and learning materials
- Researchers tracking related concepts and sources
- Anyone using Obsidian for note-taking and knowledge management
obsidian-vault FAQ
Use the find command with grep: `find "/mnt/d/Obsidian Vault/AI Research/" -name "*.md" | grep -i "keyword"` to search filenames case-insensitively.
Use Title Case for all note filenames (e.g., `My Note Title.md`). For index notes, append 'Index' to the name (e.g., `Skills Index.md`).
Use Obsidian wikilink syntax at the bottom of your note: `[[Related Note Title]]`. This creates bidirectional links that help organize your vault without folders.
Yes, use grep to search across all note files: `grep -rl "keyword" "/mnt/d/Obsidian Vault/AI Research/" --include="*.md"` to find notes containing specific text.
Search for the note's wikilink syntax across the vault: `grep -rl "\[\[Note Title\]\]" "/mnt/d/Obsidian Vault/AI Research/"` to find all backlinks.
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
- Use Title Case for filename
- Write content as a unit of learning (per vault rules)
- Add
[[wikilinks]]to related notes at the bottom - 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
More from mattpocock/skills and the wider catalog.
pr
Template and guidance for writing clear, visual pull request descriptions.
prototype
Build throwaway prototypes to validate design decisions and state models quickly.
qa
Interactive QA session that converts user bug reports into well-structured GitHub issues with codebase context.
request-refactor-plan
Plan and break down code refactors into tiny, safe commits via structured interview, then file as GitHub issue.
research
Delegate research to a background agent that investigates primary sources and documents findings.
resolving-merge-conflicts
Resolve git merge and rebase conflicts by understanding intent and preserving both changes where possible.