obsidian-vault

Search Obsidian vaults via markdown-oxide LSP with ripgrep fallback.

8|1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill obsidian-vault-joecp17
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault
Source: https://github.com/JoeCP17/LLM-Dot-files/tree/main/claude/skills/obsidian-vault
Command: npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill obsidian-vault-joecp17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vault users waste time manually locating backlinks, tag usages, and broken wiki links, and they struggle to search efficiently without blowing up token usage.

Core Features & Use Cases

  • LSP-first vault search: Uses markdown-oxide LSP to resolve wikilinks, backlinks, tag references, and headings/structure via symbols and diagnostics.
  • Fast fallback searching: Uses ripgrep and fd to find wikilink references, tag occurrences, and candidate note files when LSP is unavailable.
  • Vault-aware token optimization: Enforces scope limits (e.g., only a small number of files), ignores heavy/irrelevant folders (archive, .obsidian, attachments), and recommends compacting repeated work.
  • Best-fit workflows: Automatically supports tasks around zettelkasten organization, hierarchical tags, MOC usage, link hygiene, and note creation templates.

Quick Start

Ask an AI to find all notes that reference a given wiki link target in your Obsidian vault and report the results using the most efficient method available (markdown-oxide LSP first, ripgrep fallback).

Frequently Asked Questions about obsidian-vault

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

FAQPage Schema
How do I find backlinks and broken wiki links in an Obsidian vault without exceeding token limits?

Finding backlinks and broken wiki links in an Obsidian vault uses markdown-oxide LSP operations like findReferences and diagnostics, enforcing token-optimization rules that restrict file scope and ignore heavy folders like archive and attachments.

Can I use ripgrep to search for tag usages in Zettelkasten folders when markdown-oxide is unavailable?

Yes, searching tag usages in Zettelkasten folders uses ripgrep and fd as fast fallbacks to find tag occurrences and candidate note files when the markdown-oxide LSP is unavailable.

What is the best way to resolve wikilinks and inspect frontmatter across a Zettelkasten-style vault?

Resolving wikilinks and inspecting frontmatter across a Zettelkasten-style vault is best handled by markdown-oxide LSP operations like goToDefinition and documentSymbol, prioritizing LSP queries over manual searches.

Does vault search with markdown-oxide support hierarchical tags and MOC workflows?

Yes, vault search with markdown-oxide supports hierarchical tags and MOC workflows by applying structured vault maintenance tasks, link hygiene checks, and note creation templates within Zettelkasten-style folders.

Why does vault search ignore certain folders like attachments and archive during token optimization?

Vault search ignores folders like attachments and archive during token optimization to prevent excessive token consumption, enforcing strict scope limits that compact repeated work and exclude irrelevant heavy directories.