← Back to Skills Marketplace
119
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install qmd2
Description
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode.
Usage Guidance
This skill appears to be what it says: helper instructions for the qmd CLI. Before installing or running: (1) inspect the GitHub repository (https://github.com/tobi/qmd) to confirm you trust the maintainer and to check for install scripts or unexpected behavior; (2) be aware that npm installs can execute lifecycle scripts — consider installing in a sandbox/container if you are unsure; (3) the tool expects an Ollama instance for embeddings/rerank (OLLAMA_URL, default http://localhost:11434) — ensure you run a trusted local Ollama or adjust configuration; (4) check that writing an index to ~/.cache/qmd is acceptable for your environment and that you don’t index sensitive files unintentionally; (5) if you want stronger assurance, run qmd's source code through a brief audit or run it with network monitoring to see outbound activity during use.
Capability Analysis
Type: OpenClaw Skill
Name: qmd2
Version: 1.0.1
The skill provides a wrapper for 'qmd', a legitimate local search and indexing CLI tool. The installation process uses a public GitHub repository (github.com/tobi/qmd), and the instructions in SKILL.md are consistent with the tool's documented functionality for BM25 and vector search. No malicious patterns, data exfiltration, or suspicious execution logic were identified.
Capability Assessment
Purpose & Capability
Name/description match the required binary 'qmd' and the SKILL.md only documents using qmd for indexing/searching local files. The declared install (provides qmd) aligns with the stated purpose.
Instruction Scope
Runtime instructions are narrowly scoped to qmd CLI operations (indexing, search, status, MCP mode) and reference the index location (~/.cache/qmd). They also mention using Ollama via OLLAMA_URL (default http://localhost:11434) — this env var is referenced but not declared in the skill's requires.env metadata.
Install Mechanism
Install spec is a Node package pointing at a GitHub repository (https://github.com/tobi/qmd). This is a common pattern but has moderate risk: npm/node installs can run lifecycle scripts (arbitrary code at install time). The source is a GitHub repo (better than an unknown IP or pastebin) but you should review the repo before installing.
Credentials
The skill declares no required credentials (good). It does reference OLLAMA_URL for embeddings/rerank, which is a benign configuration variable (endpoint URL) but it was not declared. No secrets or unrelated credentials are requested.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent system privileges. It notes the index location in the user's cache directory (~/.cache/qmd), which is reasonable for this tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qmd2 - After installation, invoke the skill by name or use
/qmd2 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Skill name updated from "qmd" to "qmd2"
- Removed "homepage" field from metadata
- No changes to commands or functionality documented
v1.0.0
Initial release of qmd2 skill.
- Provides local search and indexing CLI using BM25, vectors, and rerank options.
- Supports searching, adding collections, updating and checking index status.
- Enables hybrid, BM25-only, or vector-only search modes.
- Includes MCP mode for special operations.
- Integrates with Ollama for embeddings and reranking.
- Index files stored locally under `~/.cache/qmd` by default.
Metadata
Frequently Asked Questions
What is Qmd2?
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode. It is an AI Agent Skill for Claude Code / OpenClaw, with 119 downloads so far.
How do I install Qmd2?
Run "/install qmd2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Qmd2 free?
Yes, Qmd2 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Qmd2 support?
Qmd2 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Qmd2?
It is built and maintained by Sam Biner (@sambiner); the current version is v1.0.1.
More Skills