qmd

Index and search local markdown and text documents with hybrid retrieval.

97|8|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/peteromallet/megaplan --skill qmd-peteromallet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/peteromallet/megaplan/tree/main/megaplan/agent/optional-skills/research/qmd
Command: npx skills add https://github.com/peteromallet/megaplan --skill qmd-peteromallet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Local, on-device search across markdown notes, meeting transcripts, documentation, and other text files using a hybrid retrieval approach (BM25, vector embeddings, and LLM reranking) to deliver fast, private results.

Core Features & Use Cases

  • On-device hybrid search for notes and docs.
  • MCP integration to expose Hermes Agent tools.
  • Easy indexing and querying workflow across collections for personal knowledge bases and project docs.

Quick Start

Install qmd, index your collections, and start querying your local data.

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search markdown notes and meeting transcripts locally on my device?

You can search markdown notes and transcripts locally using hybrid retrieval, which combines BM25 keyword matching, vector embeddings, and LLM reranking. This on-device approach keeps your personal knowledge base private while delivering fast results.

Do I need Node.js to index local text documents for on-device search?

Yes, you need Node.js version 22 or higher, along with SQLite extension support on macOS and the qmd package, to index local text documents and perform on-device retrieval across your personal collections.

Can I use MCP to expose local document search tools to Hermes Agent?

Yes, this skill supports MCP integration to expose local search tools directly to Hermes Agent, allowing the agent to query your indexed markdown notes and documentation on-device.

What is hybrid retrieval and how does it work for personal knowledge bases?

Hybrid retrieval combines BM25 keyword scoring, vector embeddings for semantic similarity, and LLM reranking to find relevant results. This multi-layered approach improves search accuracy across personal knowledge bases and project documentation.

What is the best way to search project documentation privately without cloud sync?

On-device indexing and search provides a private alternative to cloud-based tools. By processing markdown and text files locally with hybrid retrieval, your documentation remains completely on your machine without external data transmission.