qmd

Search local markdown notes and transcripts with hybrid BM25 and vector retrieval.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/big4council-prog/b4c-agent --skill qmd-big4council-prog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/big4council-prog/b4c-agent/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/big4council-prog/b4c-agent --skill qmd-big4council-prog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the pain of searching scattered personal documents by providing fast local retrieval across markdown notes, meeting transcripts, and text-based knowledge bases, with high-quality results through hybrid search and reranking.

Core Features & Use Cases

  • Hybrid local search (BM25 + vectors): Combines keyword matching with semantic retrieval so exact terms and concepts both work well.
  • LLM reranking for better relevance: Reranks top candidates using a local reranker model to surface the most useful passages first.
  • MCP and CLI integration: Lets you query from the terminal or expose search tools to Hermes Agent via MCP for seamless in-agent retrieval.

Use Case: You remember an action item from a meeting but not the exact wording—use qmd to find the relevant transcript lines and pull the exact document content locally.

Quick Start

Configure a qmd collection for your documents, embed the index, then ask Hermes to run a hybrid query against that collection for the topic you are trying to find.

Frequently Asked Questions about qmd

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

FAQPage Schema
How does hybrid local search combine BM25 keyword matching with vector semantic retrieval?

Hybrid local search blends BM25 keyword matching with vector semantic retrieval to locate exact terms and related concepts within markdown notes and transcripts, then applies LLM reranking to surface the most useful passages first.

What is the best way to search meeting transcripts for exact phrases and action items locally?

Searching meeting transcripts locally requires configuring a qmd collection, embedding the index, and running a hybrid query that combines keyword matching and semantic search to retrieve relevant transcript lines and exact document content.

How do I expose local knowledge base search tools to an agent via MCP integration?

You can expose local knowledge base search tools to an agent via MCP integration by starting the qmd MCP server, which allows agent-driven workflows to query your indexed markdown notes and documentation collections directly.

Can I use vector search and LLM reranking for personal documentation without relying on cloud APIs?

Yes, local RAG supports vector search and LLM reranking for personal documentation entirely on your machine. A local reranker model evaluates top candidates to prioritize the most relevant passages without requiring external cloud APIs.

Do I need a local qmd installation with indexed collections before querying my markdown notes?

Yes, you need a local qmd installation with indexed collections and generated embeddings. Use qmd commands for collection management and embedding generation before querying your markdown notes or starting the MCP server.

Why use a hybrid retrieval pipeline instead of standalone BM25 or vector search for local knowledge bases?

A hybrid retrieval pipeline is used because standalone BM25 misses semantic context and standalone vector search can overlook exact terms. Combining both ensures precise phrase matching and concept discovery across local knowledge bases.