qmd

Search local markdown notes using hybrid BM25 and vector retrieval.

19|4|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill qmd-carterwayneskhizeine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/carterwayneskhizeine/hermes-agent-windows-R/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill qmd-carterwayneskhizeine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

QMD removes the frustration of not being able to quickly find the right idea, meeting note, or doc snippet inside a growing personal knowledge base by doing fast local retrieval across many markdown and text files.

Core Features & Use Cases

  • Hybrid retrieval (BM25 + vectors): Combines keyword search with semantic vector search to handle both exact terms and conceptual queries.
  • LLM reranking for better relevance: Improves result quality by reranking top candidates using local models.
  • Local-first collection management: Indexes document directories as collections and supports adding per-collection context descriptions to boost accuracy.
  • MCP and CLI integration: Exposes search tools via MCP for agent workflows, or runs directly via the qmd CLI for interactive use.

Quick Start

Ask the system to index your knowledge base by running the command: qmd collection add <path-to-notes> --name notes, then run qmd embed to build the search index.

Frequently Asked Questions about qmd

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

FAQPage Schema
How does local hybrid RAG search work for personal markdown notes?

Local hybrid RAG search combines BM25 keyword matching with semantic vector search to find relevant markdown notes and meeting transcripts, then applies LLM reranking to improve result relevance. This handles both exact terms and conceptual queries across your knowledge base.

How do I index my markdown knowledge base for local semantic search?

To index your markdown knowledge base for local semantic search, run the command `qmd collection add <path-to-notes> --name notes` to register the directory, then execute `qmd embed` to build the BM25 and vector search index.

Can I use an MCP server tool to retrieve specific documents from my knowledge base?

Yes, you can retrieve specific documents from your knowledge base using an MCP server tool. QMD exposes search tools via MCP for agent workflows and also provides direct CLI access for interactive document retrieval by ID or path.

What is the best way to search meeting transcripts for past project decisions?

The best way to search meeting transcripts for past project decisions is using hybrid retrieval with LLM reranking. You can query concepts across projects and scope results using collection and context metadata to locate exactly where a decision was made.

Does local document retrieval support scoping by collection and context metadata?

Yes, local document retrieval supports scoping by collection and context metadata. You can index document directories as individual collections and add per-collection context descriptions to boost search accuracy and scope your queries.