qmd

Retrieve relevant markdown content using hybrid BM25 and vector search.

182|8|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/compozy/agh --skill qmd-compozy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/compozy/agh/tree/main/.agents/skills/qmd
Command: npx skills add https://github.com/compozy/agh --skill qmd-compozy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Users need fast answers from scattered markdown notes and documentation without manually hunting through files.

Core Features & Use Cases

  • Markdown Knowledge Search: Finds relevant information across markdown knowledge bases, notes, and documentation.
  • Hybrid Retrieval (lex/vec/hyde): Combines keyword matching (BM25), semantic search (vectors), and hypothetical-answer guidance to improve recall.
  • Collection Scoping + Document Retrieval: Filters results by collection and retrieves documents by path or docid for follow-up context.
  • MCP/HTTP Integration: Uses QMD via an MCP server or an HTTP API so agents can query and fetch results on demand.

Quick Start

Run the command qmd query "How does the rate limiter handle burst traffic" to get a ranked answer with supporting snippets from your embedded markdown collections.

Frequently Asked Questions about qmd

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

FAQPage Schema
How does semantic search over markdown notes work?

Semantic search over markdown notes combines lexical BM25 keyword matching with vector semantic search and optional hypothetical-answer reranking to retrieve relevant information when exact keywords are unknown.

What is the best way to search markdown documentation without knowing exact keywords?

The best way to search markdown documentation without exact keywords is using hybrid retrieval, which combines vector semantic search with BM25 lexical matching to improve recall across knowledge bases.

How do I run a query against multiple embedded markdown collections?

You run a query against multiple embedded markdown collections using query-time controls, applying collection filtering and specifying limit and expansion behavior to scope the retrieved results.

Can I use an MCP server for markdown knowledge base retrieval?

Yes, you can use an MCP server or an HTTP API for markdown knowledge base retrieval, allowing agents to query embedded markdown collections and fetch supporting document snippets on demand.

Do I need a local index to perform hybrid search on markdown files?

Yes, hybrid search requires a local index created with collection and embedding steps before you can query embedded markdown content for question answering or documentation lookup.

What are the limitations of BM25 search for documentation lookup?

BM25 lexical search alone limits documentation lookup recall when users lack exact keywords, which is why hybrid retrieval adds vector semantic search and hypothetical-answer reranking to improve results.