qmd-search

Searches a qmd-indexed resources knowledge base using semantic and keyword queries.

Updated May 3, 2026
One-click install
npx skills add https://github.com/spikelab/multiplai-cc-mktplace --skill qmd-search-spikelab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd-search
Source: https://github.com/spikelab/multiplai-cc-mktplace/tree/main/plugins/multiplai-context/skills/qmd-search
Command: npx skills add https://github.com/spikelab/multiplai-cc-mktplace --skill qmd-search-spikelab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, @tobilu/qmd, and includes scripts (resource) components.

What problem does it solve? When you need to find a specific document in your personal resources knowledge base and the automatic per-prompt retrieval missed it, this Skill lets you manually search the qmd index with deeper queries, different phrasings, and hybrid semantic-plus-keyword retrieval. ## Core Features & Use Cases - Multi-mode qmd access: Queries the qmd index over a local binary, an HTTP daemon, or an SSH bridge depending on your plugin configuration. - Authored hybrid queries: Builds typed lexical and vector search arms so rare content words drive BM25 matching while full sentences drive semantic ranking. - Chunk-level results: Returns matching chunks with line numbers and context headers, mapping qmd:// URIs back to absolute file paths for full-document reads. - Use Case: You remember saving research about a coffee varietal but the automatic retrieval surfaced nothing. Ask to search your resources, and the Skill runs a hybrid qmd query, locates the right chunk, and reads the full document before answering. ## Quick Start Ask the assistant to search your resources knowledge base for the research you saved about a specific topic. ## Quick Start Tell the assistant to search your resources for the document you need, for example by asking it to find your saved research about a particular subject.

Frequently Asked Questions about qmd-search

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

FAQPage Schema
How do I search my personal knowledge base with qmd?

Run qmd vsearch for fast semantic search, qmd search for BM25 keyword matching, or qmd query for deep hybrid retrieval with reranking. In HTTP mode, POST a typed searches array with separate lex and vec arms to the daemon's /query endpoint.

Why does qmd keyword search return no results for full sentences?

qmd's BM25 search ANDs all terms, so a full natural-language question matches nothing. Use only the 2-4 rarest content words on the lexical side and put the full sentence on the vector side or in the intent field.

What is the difference between qmd local, http, and ssh modes?

Local mode runs the qmd binary directly on PATH, http mode POSTs queries to a resident qmd mcp daemon, and ssh mode runs qmd on a host over an SSH bridge. The mode is set by the qmd_mode plugin option and each has its own reachability check.

What should I do if the qmd daemon or binary is not reachable?

Check only the configured mode: command -v qmd for local, GET /health for http, or an SSH BatchMode probe for ssh. If unreachable, install qmd, start the daemon, or fix the bridge host, and fall back to a direct grep search of the files.

How do qmd search results map back to actual files?

Result URIs look like qmd://<collection>/<relpath>, which resolves to <resources_dir>/<relpath> on disk. Results are chunk-level with line numbers, so read the full file near the reported line before answering from it.