qmd

Retrieve relevant markdown notes and transcripts using hybrid keyword and semantic search.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

qmd eliminates the frustration of finding the right information across large personal collections of markdown notes, documentation, and meeting transcripts by providing fast keyword search and higher-quality semantic retrieval locally.

Core Features & Use Cases

  • Hybrid retrieval (BM25 + vector + LLM reranking): Combine exact-match relevance with semantic understanding to surface the most useful documents for ambiguous queries.
  • Local, on-device knowledge search: Index and query your files without requiring cloud dependencies, making it suitable for private or offline workflows.
  • Hermes-friendly integration via CLI and MCP: Use directly from the terminal or expose searchable tools to Hermes Agent through an MCP server.

Use Case Example: You have hundreds of meeting transcripts and project notes; you can ask for the decisions made about the database migration and retrieve the most relevant excerpts even if the wording varies across documents.

Quick Start

Use Hermes to query your local knowledge base by running: qmd query "what decisions were made about the database migration".

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search local markdown notes and meeting transcripts with semantic retrieval?

Hybrid keyword and semantic retrieval indexes your local markdown notes and transcripts on-device, using BM25 exact-match combined with vector search and LLM reranking to surface relevant documents without cloud dependencies.

What is hybrid RAG and how does it improve personal knowledge base search?

Hybrid RAG combines BM25 keyword search for exact terms with vector semantic search for conceptual queries, then applies LLM reranking. This dual approach improves retrieval quality for ambiguous queries across personal markdown collections.

Can I use hybrid search for personal knowledge bases without cloud dependencies?

Yes, you can index and query your personal knowledge bases entirely on-device. Local embedding generation and retrieval make hybrid search suitable for private or offline workflows without requiring cloud dependencies.

Do I need Node.js to run local knowledge base indexing and search?

Yes, Node.js is required on the host to run local collection indexing and embedding generation. On macOS, optional SQLite extension support is available for enhanced functionality.

How do I query my local notes from the terminal or an MCP server?

You can query your local notes by running the qmd CLI command directly in the terminal, or by exposing searchable tools to Hermes Agent through an MCP server interface for integration.

What are the limitations of local AI semantic search for large document collections?

Local AI semantic search requires on-device processing for embedding generation, meaning performance depends on your hardware. It also requires Node.js and optional SQLite extension support on macOS for full functionality.