qmd

Search and rerank passages across locally indexed markdown knowledge bases.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

QMD removes the pain of finding the right information inside large collections of personal markdown notes, documents, and transcripts by providing fast local retrieval plus high-quality hybrid semantic search.

Core Features & Use Cases

  • Hybrid local search: combines BM25 keyword matching, vector semantic search, and LLM-based reranking to surface the most relevant passages.
  • Knowledge-base querying: searches across multiple user-defined collections such as notes, project docs, and meeting transcripts for both exact terms and conceptual questions.
  • MCP and CLI integration: exposes an MCP server (stdio or HTTP daemon) so the agent can use search tools, or uses the qmd CLI directly when you prefer terminal workflows.

Quick Start

Run a hybrid search across your indexed notes for the question “what decisions were made about the API redesign”.

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search my markdown notes locally with semantic understanding?

Local semantic search of markdown notes combines BM25 keyword matching and vector embeddings to retrieve relevant passages. This hybrid approach finds exact keyword hits and conceptually related information across your personal knowledge base.

How does hybrid search reranking work for personal knowledge bases?

Hybrid search reranking applies an optional GGUF model to evaluate and re-sort initial BM25 and vector search results. This process surfaces the most semantically relevant passages from your indexed documents and meeting transcripts.

Can I use an MCP server to query my local markdown documentation?

Yes, you can query local markdown documentation through an MCP server using stdio or HTTP daemon modes. This allows agent-based tools to access your indexed knowledge base for retrieval and documentation exploration tasks.

What is needed to index markdown documents for local retrieval?

Indexing markdown documents for local retrieval requires SQLite-backed storage to manage BM25 keyword data and vector embeddings. This local indexing setup enables fast discovery of relevant passages across your personal notes.

Does local knowledge base search support CLI workflows?

Local knowledge base search supports CLI workflows, allowing you to run hybrid queries directly from the terminal. This provides an alternative to MCP server integration for users who prefer command-line document exploration.