← Back to Skills Marketplace
satvik374

Qmd

by Satvik374 · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
277
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install qmd-2
Description
Search markdown knowledge bases, notes, and documentation using QMD. Use when users ask to search notes, find documents, or look up information.
Usage Guidance
This skill appears to do what it says (search local markdown) but you should be cautious before installing or enabling it: 1) Verify the npm package (@tobilu/qmd) and its source code/reputation before running npm install -g; prefer reviewing the package on npm/GitHub or installing in a sandbox/container. 2) Be aware qmd will read whatever directories you add as collections — only add directories you trust and avoid system or secrets-containing paths. 3) The references suggest adding qmd as an MCP server in agent configs (e.g., ~/.openclaw/openclaw.json); back up those config files before modifying them and understand that this grants the tool persistent integration with your agent. 4) If you will run qmd mcp --http (daemon), consider firewall/port controls (default 8181) and whether you want a local HTTP endpoint. 5) If you need lower risk, keep the skill instruction-only (do not modify agent config) and run qmd manually in a controlled environment. If you want this skill, validate the package and its behavior first; the metadata omission of the expected qmd binary is a small inconsistency but not necessarily malicious.
Capability Analysis
Type: OpenClaw Skill Name: qmd-2 Version: 0.1.0 The skill bundle provides a legitimate interface for searching local markdown knowledge bases using the 'qmd' utility. It defines standard MCP tools (query, get, multi_get, status) and limits the agent's execution scope to the 'qmd' command and its associated MCP server, following the principle of least privilege. No indicators of data exfiltration, malicious execution, or prompt injection were found in SKILL.md or the reference documentation.
Capability Assessment
Purpose & Capability
The SKILL.md consistently documents using the qmd CLI / MCP server to search markdown collections, which aligns with the skill name and description. However, the registry metadata declares no required binaries or install steps while the instructions clearly expect a qmd CLI (npm package @tobilu/qmd) and optionally running an MCP server — a minor mismatch between metadata and runtime expectations.
Instruction Scope
Runtime instructions instruct the agent/user to add local directories as collections (e.g., qmd collection add ~/notes) which requires reading local files (expected for a search tool). More importantly, the references explicitly show edits to client config files (~/.claude/settings.json, ~/Library/... , ~/.openclaw/openclaw.json) to register an MCP server. That involves modifying other agent/application configuration and enabling a local HTTP daemon (qmd mcp --http), which increases the skill's scope beyond simple search.
Install Mechanism
There is no formal install spec in the registry (instruction-only), but SKILL.md recommends installing via npm install -g @tobilu/qmd. Installing a third-party npm package globally is a common but potentially risky action — the package and its provenance should be verified before installing. No direct download URLs or obfuscated installs are present.
Credentials
The skill does not request environment variables, credentials, or config paths in the registry metadata. The instructions do reference user-local paths (home directories) when adding collections and show how to configure MCP servers, but they do not ask for unrelated credentials or secrets.
Persistence & Privilege
The skill does not request always:true, but the docs recommend registering qmd as an MCP server in the agent/client configuration (e.g., ~/.openclaw/openclaw.json). That is a change to the agent's configuration/behavior and effectively grants persistent integration (and potentially autonomous access to local files via the qmd daemon). Users should be aware this modifies agent settings beyond the skill's own isolated files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install qmd-2
  3. After installation, invoke the skill by name or use /qmd-2
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of qmd-2 skill. - Enables searching markdown notes, docs, and knowledge bases using the QMD CLI or MCP server. - Supports keyword (lex), semantic (vec), and hypothetical document (hyde) query types, with disambiguation options. - Allows filtering by collections and combining query types for best results. - Includes guidance for writing effective queries and using QMD via CLI and HTTP API. - Requires installation of qmd CLI (`npm install -g @tobilu/qmd`).
Metadata
Slug qmd-2
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Qmd?

Search markdown knowledge bases, notes, and documentation using QMD. Use when users ask to search notes, find documents, or look up information. It is an AI Agent Skill for Claude Code / OpenClaw, with 277 downloads so far.

How do I install Qmd?

Run "/install qmd-2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Qmd free?

Yes, Qmd is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Qmd support?

Qmd is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Qmd?

It is built and maintained by Satvik374 (@satvik374); the current version is v0.1.0.

💬 Comments