← Back to Skills Marketplace
Max QMD Search
by
sonnenberglauramarie-afk
· GitHub ↗
· v1.0.0
264
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install max-qmd
Description
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode.
README (SKILL.md)
qmd
Use qmd to index local files and search them.
Indexing
- Add collection:
qmd collection add /path --name docs --mask "**/*.md" - Update index:
qmd update - Status:
qmd status
Search
- BM25:
qmd search "query" - Vector:
qmd vsearch "query" - Hybrid:
qmd query "query" - Get doc:
qmd get docs/path.md:10 -l 40
Notes
- Embeddings/rerank use Ollama at
OLLAMA_URL(defaulthttp://localhost:11434). - Index lives under
~/.cache/qmdby default. - MCP mode:
qmd mcp.
Usage Guidance
This skill appears to be a straightforward wrapper around the qmd CLI and is coherent with its description. Before installing: (1) review the GitHub repo (https://github.com/tobi/qmd) for any postinstall scripts or surprising behavior; (2) confirm you are comfortable letting the tool read and write an index under ~/.cache/qmd; (3) be aware it will call an Ollama endpoint (default http://localhost:11434) for embeddings/rerank — if you set OLLAMA_URL to a remote host, documents sent for embedding could leave your machine; prefer a local Ollama instance or explicitly set OLLAMA_URL. The ownerId mismatch in metadata is a packaging inconsistency worth double-checking with the publisher if provenance is important.
Capability Analysis
Type: OpenClaw Skill
Name: max-qmd
Version: 1.0.0
The skill bundle provides an interface for 'qmd', a local file indexing and search tool. The installation process uses a public GitHub repository (github.com/tobi/qmd) and the commands described in SKILL.md are consistent with its stated purpose of BM25 and vector search. No indicators of data exfiltration, malicious execution, or prompt injection were found.
Capability Assessment
Purpose & Capability
Name/description, required binary (qmd), and runtime instructions all align: the skill is a thin wrapper around the qmd CLI. Minor metadata mismatch: the _meta.json ownerId differs from the registry Owner ID provided, which could indicate inconsistent packaging/metadata but does not change the technical behavior.
Instruction Scope
SKILL.md only tells the agent to run qmd commands, index local files, and query the index. It references the OLLAMA_URL env var (default http://localhost:11434) and the local index path (~/.cache/qmd). These are within the expected scope for a local search tool, but the SKILL.md references an env var that is not declared in the registry metadata (requires.env), so the agent may read that variable at runtime even though it wasn't listed.
Install Mechanism
Install spec uses a Node package pointing at a GitHub repository (https://github.com/tobi/qmd) which will create the qmd binary. Installing a package directly from a GitHub repo is a common choice but carries moderate risk because postinstall scripts or repository content can run arbitrary code during install. This is not unusual for a CLI but is worth auditing the repository before installing.
Credentials
The skill declares no required environment variables, but the instructions expect OLLAMA_URL for embedding/rerank (defaulting to a localhost endpoint). No unrelated credentials are requested. The mismatch between declared env requirements and the documented OLLAMA_URL is a small inconsistency to be aware of.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges. The tool reads/writes its index under ~/.cache/qmd which is expected for a local indexing tool and does not modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install max-qmd - After installation, invoke the skill by name or use
/max-qmd - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Local BM25 + vector search + rerank with MCP mode
Metadata
Frequently Asked Questions
What is Max QMD Search?
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode. It is an AI Agent Skill for Claude Code / OpenClaw, with 264 downloads so far.
How do I install Max QMD Search?
Run "/install max-qmd" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Max QMD Search free?
Yes, Max QMD Search is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Max QMD Search support?
Max QMD Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Max QMD Search?
It is built and maintained by sonnenberglauramarie-afk (@sonnenberglauramarie-afk); the current version is v1.0.0.
More Skills