obsidian-vault

Search, create, and organize Markdown notes in an Obsidian vault using wikilinks and index notes.

Updated May 11, 2026
One-click install
npx skills add https://github.com/mmnavarr/harness --skill obsidian-vault-mmnavarr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-vault
Source: https://github.com/mmnavarr/harness/tree/main/skills/obsidian-vault
Command: npx skills add https://github.com/mmnavarr/harness --skill obsidian-vault-mmnavarr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a personal knowledge base in Obsidian requires consistent naming, linking, and discovery conventions. This Skill provides the vault location, naming rules, and search workflows so notes stay findable and interconnected without folder hierarchies. ## Core Features & Use Cases - Note Search: Find notes by filename or content using find, grep, or Grep/Glob tools against the vault path. - Note Creation: Create Title Case notes with wikilinks to related notes at the bottom, following the vault's flat-structure conventions. - Backlink & Index Discovery: Locate all notes linking to a given note and find index notes that aggregate related topics. - Use Case: You want to capture a new concept about retrieval-augmented generation. Create a new note titled in Title Case, write the content as a unit of learning, add wikilinks to related notes, and link it from the RAG Index note. ## Quick Start Search my Obsidian vault for notes about RAG and create a new note summarizing what you find with links to the related index note.

Frequently Asked Questions about obsidian-vault

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search notes in an Obsidian vault from the command line?▼

Use find with grep to search by filename, or grep -rl with --include="*.md" to search note contents. You can also point Grep or Glob tools directly at the vault path for the same results.

How do I find backlinks to a note in Obsidian?▼

Search the vault for the wikilink pattern of the target note, for example grep -rl "\[\[Note Title\]\]" across all Markdown files. Every file returned contains a link to that note.

What naming convention should Obsidian notes use?▼

This vault uses Title Case for all note filenames and keeps a flat structure with no folders. Organization happens through wikilinks and index notes that aggregate related topics.

Can I organize Obsidian notes without folders?▼

Yes, this vault avoids folders entirely and relies on wikilinks plus index notes for structure. Index notes are simple lists of wikilinks grouping related topics, and backlinks provide reverse navigation.

What are the limitations of grep-based note search?▼

Grep searches raw text, so it does not understand Obsidian features like aliases, tags panels, or graph relationships. For semantic or ranked search across a large vault, a dedicated search index would be needed.