qmd

Search local markdown and meeting transcripts with hybrid BM25, vector, and reranking retrieval.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill qmd-afel6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/optional-skills/research/qmd
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill qmd-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables fast, high-quality search across personal knowledge bases, markdown notes, project documentation, and meeting transcripts on-device without relying on cloud services.

Core Features & Use Cases

  • Hybrid Retrieval: Combines BM25 keyword search, semantic vector search, and LLM-powered reranking for high relevance.
  • Local-first & Private: Runs entirely on the user's machine with optional GGUF models and local index storage.
  • MCP & CLI Integration: Exposes tools via MCP for agent integration or direct CLI for ad-hoc queries, suited for research, codebase discovery, and meeting follow-ups.
  • Practical Example: Query a project-docs collection to find design decisions from past meetings and return the top-ranked passages for summarization.

Quick Start

Search my project-docs collection for "database migration plan" and return the top five hybrid-ranked passages.

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 without sending data to the cloud?

You can search local markdown notes and meeting transcripts entirely on-device using a hybrid retrieval pipeline that combines BM25 keyword search, vector embeddings, and LLM reranking. This keeps your personal knowledge base private and runs without cloud services.

How does hybrid retrieval combine BM25 and vector search for local knowledge bases?

Hybrid retrieval merges BM25 keyword search with semantic vector search and then applies LLM-powered reranking to refine relevance. This combination ensures both exact keyword matches and contextual meaning are captured when querying local knowledge bases.

Can I use semantic search over project documentation through an MCP integration?

Yes, you can query project documentation through MCP integration for agent-based workflows or use the CLI for ad-hoc queries. The daemonized MCP HTTP mode supports low-latency queries for targeted information retrieval.

Do I need Node.js and local GGUF models to run semantic search on personal notes?

You need Node.js version 22 or higher and the qmd installation to run the search pipeline. Optional GGUF local models can be configured for generating vector embeddings and performing LLM reranking on your machine.

What is the best way to find past design decisions from local meeting transcripts?

The best way is to query your meeting transcript collection using the hybrid search pipeline. It will retrieve and return the top-ranked passages containing design decisions, which you can then use for summarization or follow-up tasks.

Are there limitations when running local AI search for codebase discovery?

Limitations depend on your local hardware capacity when running optional GGUF models for embeddings and reranking. Processing large project documentation collections on-device may be constrained by available memory and compute resources.