qmd

Index and search local knowledge bases with hybrid retrieval.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search personal knowledge bases locally using qmd's hybrid retrieval engine, enabling fast keyword and semantic search without relying on cloud services.

Core Features & Use Cases

  • Local on-device search across Markdown notes, transcripts, documentation, and other text files.
  • Hybrid retrieval combines BM25 keyword search, vector embeddings, and LLM-based reranking for high-quality results.
  • MCP integration enables Hermes Agent to access qmd tools directly without loading the skill each time.

Quick Start

Index a local folder of notes and run a search with qmd search to see results.

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 transcripts without cloud dependencies?

To search local Markdown notes and transcripts without cloud dependencies, use a local search engine that runs entirely on-device. This Skill uses a hybrid retrieval engine combining BM25, vector search, and LLM reranking to return relevant results offline.

What is hybrid retrieval and how does it improve vector search results?

Hybrid retrieval improves vector search results by combining BM25 keyword matching with vector embeddings and LLM-based reranking. This approach ensures both exact keyword lookups and concept-based semantic queries return highly relevant context from indexed collections.

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

Yes, you need Node.js version 22 or higher to run this local knowledge base search. You also need to download local models for embedding and reranking to ensure the process operates completely offline without relying on cloud services.

Can I use MCP integration to search personal knowledge bases directly?

Yes, you can use MCP integration to search personal knowledge bases directly. MCP integration enables the Hermes Agent to access search tools natively without loading the Skill each time, streamlining collection management and context descriptions.

What is the best way to manage multiple collections for local search?

The best way to manage multiple collections for local search is using CLI workflows provided by the engine. You can index folders, generate embeddings, and run context descriptions across multiple project documentation and note collections efficiently.

Are there limitations to running LLM reranking entirely on-device?

Limitations of running LLM reranking entirely on-device include requiring sufficient local hardware resources to execute downloaded models. You must manage local installations and prerequisites manually, as the system avoids cloud dependencies for its hybrid retrieval processes.