qmd

Search local markdown knowledge bases with BM25, vector search, and LLM reranking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the challenge of efficiently searching through vast personal knowledge bases, documents, and notes with a local, powerful search engine.

Core Features & Use Cases

  • Local Search Engine: Indexes markdown notes, meeting transcripts, and documentation, providing a hybrid search combining keyword matching and semantic understanding.
  • Hybrid Search: Uses BM25, vector search, and LLM reranking to ensure comprehensive and accurate results.
  • CLI and MCP Integration: Supports both command-line interface and Microcontroller Protocol (MCP) integration for seamless use with other systems.
  • Use Case: When a user needs to find specific information within a large collection of markdown/text files, or set up a local document search system.

Quick Start

Add your documents to qmd collections, generate embeddings, and then use the 'qmd search' command to query your knowledge base.

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search my local markdown notes and personal knowledge base?

Local search for markdown notes is achieved by indexing documents into collections and generating embeddings. The system applies a hybrid search engine combining BM25, vector search, and LLM reranking to retrieve relevant text directly on your device.

What is hybrid search for personal documents and how does it work?

Hybrid search for personal documents combines keyword matching with semantic understanding. It uses BM25 for exact term frequency, vector search for semantic similarity, and LLM reranking to refine and order the most accurate results from your knowledge base.

Can I use local document search with MCP integration?

Yes, local document search supports Microcontroller Protocol (MCP) integration. This allows you to seamlessly query your indexed markdown notes and text files through external systems alongside the standard command-line interface.

How do I set up a local knowledge base search engine for meeting transcripts?

To set up local knowledge base search for meeting transcripts, add your transcript files to document collections and generate embeddings. You can then execute queries using the command-line interface to find specific information across your text files.

Does on-device document search require an internet connection?

On-device document search operates locally without requiring an external internet connection. By generating local embeddings and utilizing BM25 with vector search, your personal knowledge base queries and document retrieval remain entirely private.

What is the best way to retrieve specific information from a large collection of text files?

The best way to retrieve specific information from large text file collections is using a hybrid search engine. It indexes documents locally and applies BM25, vector search, and LLM reranking to ensure comprehensive and accurate query results.