About obsidian-vault
A skill for working with an Obsidian vault at a specified path, documenting its naming, linking, and organization conventions. It also describes shell-based workflows for searching notes and finding related pages.
Key features
- 01Documents vault location and conventions
- 02Uses Title Case note names
- 03Organizes notes with wikilinks and indexes
- 04Searches filenames and note contents
- 05Finds backlinks and index notes
Use cases
- 01Creating notes that follow vault conventions
- 02Finding notes by name or content
- 03Locating related notes and indexes
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/obsidian-vaultin Claude Code to confirm it loaded.
Details
From the project READMEObsidian 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*"
Comments
Markdown supported