← Back to Skills Marketplace
emcmillan80

QMD - Quick Markdown Search

by emcmillan80 · GitHub ↗ · v1.0.0
darwinlinux ⚠ suspicious
2502
Downloads
0
Stars
9
Active Installs
1
Versions
Install in OpenClaw
/install qmd-markdown-search
Description
Local hybrid search for markdown notes and docs. Use when searching notes, finding related content, or retrieving documents from indexed collections.
Usage Guidance
This skill appears to be a legitimate local markdown search helper that relies on the external 'qmd' binary and (optionally) local LLM models. Before installing, verify the upstream GitHub repo (https://github.com/tobi/qmd) so you know what code will be installed. Be aware that: (1) the first run can auto-download GGUF models into ~/.cache/qmd/models (large files and network activity), (2) installation uses 'bun install -g' which adds third-party code to your system, and (3) scheduling index/embedding jobs (cron or agent scheduler) will run qmd commands regularly against files you index. If you need stricter control, run qmd in a sandbox or VM, inspect the repository you install from, and confirm model download sources and network endpoints before allowing automatic downloads.
Capability Analysis
Type: OpenClaw Skill Name: qmd-markdown-search Version: 1.0.0 The skill is classified as suspicious due to the installation method and the inherent risks involved. The `SKILL.md` instructs the agent to install `qmd` via `bun install -g https://github.com/tobi/qmd`. This command downloads and executes code from a remote GitHub repository, introducing a supply chain risk. While the tool's stated purpose of local markdown search is benign, and the instructions to the agent are operational guidance rather than malicious prompt injection, the act of installing arbitrary remote code and granting it broad local file system and network access (for model downloads) constitutes a meaningful high-risk behavior without clear malicious intent, aligning with the 'suspicious' threshold.
Capability Assessment
Purpose & Capability
The SKILL.md describes a local markdown search tool that runs the qmd binary and may load local LLM models; that aligns with the stated purpose. However, the registry metadata for this skill lists no required binaries or env vars while the SKILL.md requires Bun and the qmd binary (and includes a bun install command). This mismatch is likely just an authoring gap but is worth noting.
Instruction Scope
Runtime instructions are narrowly scoped to installing/using qmd, adding collections, running search/embed/update commands, and optionally scheduling cron jobs. The skill instructs indexing local files and storing models/cache under ~/.cache/qmd/models (or XDG_CACHE_HOME). There are no instructions to read unrelated system config or exfiltrate secrets.
Install Mechanism
There is no install spec in the registry, but SKILL.md includes an install step using 'bun install -g https://github.com/tobi/qmd' (GitHub). Installing via Bun from a GitHub repo is common but should be treated as a network install from third-party code; model downloads at first run are also expected. This is moderate-risk compared with purely instruction-only skills but coherent for the tool's function.
Credentials
The skill does not request credentials or sensitive environment variables. It asks the user to ensure Bun is on PATH and notes where models/cache are stored. These are proportionate to a local search/indexing tool.
Persistence & Privilege
The skill is not always-enabled and is user-invocable. It suggests optional cron scheduling for index updates, but does not demand permanent elevated presence or modify other skills' configs. Autonomous invocation is allowed (platform default) but not combined with other high-risk indicators here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install qmd-markdown-search
  3. After installation, invoke the skill by name or use /qmd-markdown-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Local hybrid search for markdown notes: BM25 keyword search + semantic search with vector embeddings, running on-device with auto-downloaded models.
Metadata
Slug qmd-markdown-search
Version 1.0.0
License
All-time Installs 10
Active Installs 9
Total Versions 1
Frequently Asked Questions

What is QMD - Quick Markdown Search?

Local hybrid search for markdown notes and docs. Use when searching notes, finding related content, or retrieving documents from indexed collections. It is an AI Agent Skill for Claude Code / OpenClaw, with 2502 downloads so far.

How do I install QMD - Quick Markdown Search?

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

Is QMD - Quick Markdown Search free?

Yes, QMD - Quick Markdown Search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does QMD - Quick Markdown Search support?

QMD - Quick Markdown Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created QMD - Quick Markdown Search?

It is built and maintained by emcmillan80 (@emcmillan80); the current version is v1.0.0.

💬 Comments