About obsidian-vault
obsidian-vault is a set of conventions and workflows for an Obsidian AI Research vault. It helps users organize research notes through consistent naming, links, indexes, and search.
Key features
- 01Consistent note naming
- 02Connect notes with Wikilinks
- 03Collect topics in index notes
- 04Search filenames or note content
- 05Find backlinks and index notes
Use cases
- 01Search a vault for keywords
- 02Create and link research notes
- 03Organize topic indexes
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ utarn/ engineer-skills --skill obsidian-vaultAfter 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