qmd

Combine BM25 keyword matching, vector search, and LLM reranking for hybrid local retrieval.

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill qmd-jamesfincher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/JamesFincher/gengar/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/JamesFincher/gengar --skill qmd-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Finding the right note, transcript, or doc inside a large personal knowledge base is slow and error-prone, especially when you do not remember exact keywords.

Core Features & Use Cases

  • Hybrid local retrieval (BM25 + vectors + LLM reranking): Combines fast keyword search with semantic matching and reorders results using an LLM reranker.
  • Document indexing and collections: Indexes markdown/text files from multiple directories as named collections with optional context descriptions for better relevance.
  • MCP + CLI integration: Use it directly via the qmd CLI or connect through an MCP server so the agent can query your knowledge base on demand.

Real-world use: you ask for decisions made about a project’s API redesign, and qmd finds relevant meeting transcripts and docs even if your phrasing differs from what was written.

Quick Start

Run qmd query "what decisions were made about the API redesign" on your indexed collections to get the most relevant documents with reranked results.

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I perform local semantic search across my markdown notes and meeting transcripts?

Local semantic search across markdown notes and meeting transcripts is performed by combining BM25 keyword matching, vector embeddings, and LLM-based reranking to retrieve relevant documents from indexed collections via CLI or MCP.

Can I use an MCP server to let my agent query a local knowledge base?

Yes, you can use an MCP server to let your agent query a local knowledge base. The MCP integration allows agents to perform on-demand retrieval across indexed markdown and text collections using hybrid search.

What is the best way to find specific information in a large personal knowledge base without exact keywords?

The best way to find information without exact keywords is hybrid local retrieval, which matches semantic meaning using vectors alongside BM25 keyword matching and then applies LLM reranking to return the most relevant documents.

Do I need Node.js to index markdown files for local document retrieval?

Yes, you need Node.js version 22 or higher to index markdown files for local document retrieval. The system installs models locally and uses an embedded SQLite index to store and query your collections.

How does LLM-based reranking improve knowledge base search results?

LLM-based reranking improves knowledge base search results by reordering the initial BM25 and vector matches using a language model, ensuring the returned documents best align with the specific query intent and contextual relevance.

Can I search multiple project documentation directories as separate named collections?

Yes, you can index markdown and text files from multiple project documentation directories as named collections, optionally adding context descriptions to improve search relevance across different knowledge bases.