← Back to Skills Marketplace
4838
Downloads
4
Stars
18
Active Installs
1
Versions
Install in OpenClaw
/install qmd-cli
Description
Search and retrieve markdown documents from local knowledge bases using qmd. Supports BM25 keyword search, vector semantic search, and hybrid search with LLM re-ranking. Use for querying indexed notes, documentation, meeting transcripts, and any markdown-based knowledge. Requires qmd CLI installed (bun install -g https://github.com/tobi/qmd).
Usage Guidance
Install only if you trust the qmd project, prefer a pinned release or reviewed package when possible, and index only folders you are comfortable making searchable by your agent. Use the MCP server only with trusted clients and avoid full-document or all-match retrieval on highly sensitive notes unless you intend that content to enter the conversation.
Capability Analysis
Type: OpenClaw Skill
Name: qmd-cli
Version: 1.1.0
The skill instructs the agent to install a global CLI tool (`qmd`) from a remote GitHub repository (`https://github.com/tobi/qmd`) using `bun install -g` as detailed in `SKILL.md`. This constitutes a supply chain risk, as the installation process can execute arbitrary code from the remote package. Additionally, the skill can instruct the agent to run `qmd mcp`, which starts a server process, potentially exposing an attack surface. While these actions are aligned with the stated purpose of providing `qmd` functionality, they involve high-privilege operations and risky capabilities without clear malicious intent from the skill bundle itself.
Capability Assessment
Purpose & Capability
The commands match the stated purpose: indexing, searching, and retrieving local markdown knowledge bases. The capability can expose private notes, docs, and transcripts to the agent, so collection scope matters.
Instruction Scope
The instructions are mostly examples and user-directed commands. Broad options like full-document retrieval, all matches, and query reranking are disclosed enough for a search skill, though users should avoid broad searches over sensitive collections.
Install Mechanism
The skill is instruction-only, but it tells users to globally install an external CLI from GitHub with bun. That is disclosed and central to the skill, but it is unpinned and should be treated as a normal third-party package trust decision.
Credentials
Indexing ~/notes and generating embeddings is proportionate for local markdown search. Upstream qmd documentation describes the LLM reranking as running locally via node-llama-cpp with GGUF models, which downgrades the scanner concern about undisclosed remote LLM exposure. ([github.com](https://github.com/tobi/qmd?utm_source=openai))
Persistence & Privilege
The index and embeddings are persistent local search state, and the optional MCP server exposes retrieval tools if the user starts it. The artifact does not show hidden startup persistence, credential use, privilege escalation, or automatic background execution.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qmd-cli - After installation, invoke the skill by name or use
/qmd-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Add better support for updates
Metadata
Frequently Asked Questions
What is QMD CLI?
Search and retrieve markdown documents from local knowledge bases using qmd. Supports BM25 keyword search, vector semantic search, and hybrid search with LLM re-ranking. Use for querying indexed notes, documentation, meeting transcripts, and any markdown-based knowledge. Requires qmd CLI installed (bun install -g https://github.com/tobi/qmd). It is an AI Agent Skill for Claude Code / OpenClaw, with 4838 downloads so far.
How do I install QMD CLI?
Run "/install qmd-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is QMD CLI free?
Yes, QMD CLI is completely free (open-source). You can download, install and use it at no cost.
Which platforms does QMD CLI support?
QMD CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created QMD CLI?
It is built and maintained by dpaluy (@dpaluy); the current version is v1.1.0.
More Skills