qmd

Index markdown and text documents for local hybrid search with reranking.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill qmd-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/MarbleSodas/Mavis/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill qmd-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding the right note, doc, or meeting transcript across a growing personal knowledge base is slow and unreliable when you only have keyword search or vague memory.

Core Features & Use Cases

  • Local Hybrid Retrieval: Combines BM25 keyword matching with vector semantic search and LLM reranking for higher-quality results on-device.
  • Document Indexing for Personal Knowledge: Indexes markdown notes, meeting transcripts, documentation, and other text-based files into searchable collections.
  • MCP & CLI Access: Supports both direct CLI usage and an MCP server so an agent can call search and retrieval tools automatically.

Quick Start

Ask: "Search my qmd collection for the decision we made about the API redesign, and return the most relevant excerpts."

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search markdown notes and meeting transcripts locally with semantic search?

You can search markdown notes and meeting transcripts locally by indexing text documents into a collection and using hybrid retrieval modes that combine BM25 keyword matching with vector semantic search and LLM reranking.

How does hybrid RAG improve local knowledge base search results?

Hybrid RAG improves local knowledge base search by combining BM25 keyword matching with vector semantic search and LLM reranking, returning highly relevant excerpts for fast keyword lookup or semantic question answering on personal notes.

Can I use an MCP server to let my AI agent search my personal knowledge base?

Yes, you can use the integrated MCP server to let an AI agent automatically call search and retrieval tools to query your indexed markdown and text document collections directly.

Do I need Node.js 22 to run local hybrid search on my notes?

Yes, local hybrid search across personal knowledge bases requires Node.js 22 or higher, along with local collection and index setup, and optional SQLite extension support on macOS.

What is the best way to find a specific decision in my meeting transcripts without manual reading?

The best way to find specific decisions in meeting transcripts is using the query mode, which applies hybrid BM25 and vector search with reranking to return the most relevant excerpts from your indexed documents.

What are the limitations of using local search for a large personal knowledge base?

Limitations include requiring local collection and index setup for your documents, needing Node.js 22+ on your machine, and configuring optional SQLite extension support if you are running the search on macOS.