qmd-obsidian

Index and search Obsidian vault notes with qmd keyword and semantic queries.

1|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/jpjednorski/obsidian-vault-ai-starter --skill qmd-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd-obsidian
Source: https://github.com/jpjednorski/obsidian-vault-ai-starter/tree/main/.cursor/skills/qmd-obsidian
Command: npx skills add https://github.com/jpjednorski/obsidian-vault-ai-starter --skill qmd-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill indexes and searches an Obsidian vault using qmd to deliver fast, relevant note results.

Core Features & Use Cases

  • QMD indexing: Build and query a searchable index over Notes, Meetings, Projects, and People stored in the vault.
  • Multi-mode search: Perform BM25 keyword searches, semantic searches, and hybrid ranking to surface precise results.
  • Use Case: Imagine you need to locate all notes about onboarding; run a qmd search to retrieve matching files with context.

Quick Start

Use the qmd-obsidian skill to index and search your vault. Example:

  • qmd status
  • If not a collection, add: qmd collection add "<vault-root>" --name obsidian-vault --mask "**/*.md"
  • qmd search "onboarding" -c obsidian-vault

Frequently Asked Questions about qmd-obsidian

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

FAQPage Schema
How do I index and search an Obsidian vault for specific notes?

To index and search an Obsidian vault, you add the vault as a collection using a markdown file mask, then execute a query to retrieve matching files. The skill requires qmd tooling installed and uses commands like collection add and search to surface notes.

Can I perform semantic search across my Obsidian notes and meetings?

Yes, you can perform semantic search across Obsidian notes and meetings. The skill supports multi-mode search including BM25 keyword searches, semantic searches, and hybrid ranking to deliver precise and contextually relevant results from your vault.

Do I need qmd installed to use this Obsidian vault search skill?

Yes, you need qmd tooling installed locally. The skill relies on qmd command-line operations such as status, collection add, context add, search, vsearch, and query to index the vault and retrieve structured outputs.

What is the difference between keyword and semantic search in an Obsidian vault?

Keyword search uses BM25 ranking to find exact term matches, while semantic search interprets meaning to find conceptually related notes. The skill supports both modes plus hybrid ranking to surface precise results across notes, docs, and meetings.

How do I get structured JSON or Markdown outputs from Obsidian vault searches?

You get structured JSON or Markdown outputs by running qmd search or query commands against your indexed Obsidian vault. The skill emits these formats natively, allowing you to integrate the retrieved notes and meeting context into downstream applications.