About obsidian-vault
obsidian-vault is a skill for searching and maintaining notes in an Obsidian vault. It documents the vault location, naming and linking conventions, and command-line workflows for finding related notes and creating new ones.
Key features
- 01Search note filenames and contents
- 02Follow Title Case naming conventions
- 03Link notes with Obsidian wikilinks
- 04Find backlinks and index notes
- 05Create notes using vault guidelines
Use cases
- 01Finding notes related to a topic
- 02Adding a linked note to an existing vault
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.
Bundled filesagents/openai.yaml
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