qmd

Search local markdown and text collections with hybrid retrieval and reranking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

qmd eliminates the frustration of manually searching large personal document collections by combining fast keyword matching with semantic retrieval and LLM reranking.

Core Features & Use Cases

  • Hybrid Local Search (BM25 + Vector + Reranking): Finds both exact terms and conceptually related notes across markdown and text documents.
  • Collection & Context-Aware Indexing: Organizes documents into named collections and improves results using per-collection context descriptions.
  • MCP/CLI Integration for On-Demand Retrieval: Use qmd directly from the terminal or expose it to Hermes Agent via an MCP server.

Quick Start

Tell Hermes Agent: "Search my qmd collections for decisions made about the database migration and return the most relevant notes."

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I perform local search across my markdown notes and documents?

Local search across markdown notes uses hybrid retrieval, combining BM25 keyword matching with semantic vector search and LLM reranking to find exact terms and conceptually related text across your personal knowledge base.

Can I use RAG to query specific collections of meeting transcripts?

RAG queries can be scoped to specific named collections of meeting transcripts, allowing targeted retrieval over indexed documents by organizing files into collections and optionally adding context descriptions for better results.

Does hybrid retrieval work with the Hermes Agent via MCP integration?

Hybrid retrieval works with Hermes Agent by exposing searchable collections through a configurable MCP server, enabling the agent to query your local knowledge base and return relevant notes on demand.

What is the best way to combine keyword and semantic search for a personal knowledge base?

Combining keyword and semantic search for a personal knowledge base requires a hybrid approach that runs BM25 exact term matching alongside vector embedding retrieval, followed by LLM reranking to surface the most relevant documents.

Do I need to index my text files locally before querying them?

Local indexing of text and markdown files is required before querying, organizing documents into named collections with optional context descriptions to enable accurate hybrid retrieval and reranking.

Can I search my local notes directly from the command line?

You can search local notes directly from the command line using CLI integration, querying indexed collections to retrieve relevant information without needing to expose the search tools through an MCP server.