qmd

Search markdown collections using BM25, vector retrieval, and LLM reranking.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/escotilha/claude-public --skill qmd-escotilha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/escotilha/claude-public/tree/main/skills/qmd
Command: npx skills add https://github.com/escotilha/claude-public --skill qmd-escotilha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You can’t quickly locate the exact skill, pattern, decision, or prior note you need across a growing markdown knowledge base, especially when your phrasing doesn’t match the stored wording.

Core Features & Use Cases

  • Hybrid semantic search (BM25 + vectors + LLM rerank): Returns relevant matches even when queries are loosely phrased.
  • Cross-collection discovery: Searches skills, agents, rules, memory, and project docs to reduce lookup time.
  • Low-confidence fallback keyword search: Recovers cases where vector search misses exact entity/tool/error-string terms.
  • Structured vs human-friendly output: Supports both user-facing result formatting and agent-spawned structured responses.

Quick Start

Use the qmd skill to search your knowledge base for the skill or rule related to your question, by asking: " /qmd pattern de tratamento de erros ".

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search markdown documentation when my query doesn't match the exact wording?

Hybrid semantic search combines BM25 keyword search, vector retrieval, and LLM reranking to find relevant markdown documents even when your query phrasing differs from the stored text, returning accurate matches across collections.

What is the best way to discover which skill or rule matches a specific function across a knowledge base?

Cross-collection discovery searches skills, agents, rules, memory, and project docs to locate documented patterns and decisions, reducing lookup time by applying hybrid retrieval and LLM reranking across all markdown collections.

Why does semantic search miss exact entity names and error strings in my markdown files?

Vector semantic search can miss exact entity, tool, or error-string terms, but a low-confidence fallback keyword search recovers these cases by automatically executing a BM25 query when vector results are empty or low confidence.

Can I scope markdown semantic search to specific collections like memory or rules?

Yes, QMD hybrid query execution supports optional collection scoping, allowing you to restrict searches to specific markdown collections such as rules, memory, or project docs to retrieve more targeted results.

Does markdown knowledge base search support structured responses for agent-spawned tasks?

Yes, the search supports both user-facing result formatting and agent-spawned structured responses, enabling automated workflows to consume retrieval outputs directly from markdown collections.