← Back to Skills Marketplace
levineam

qmd External Knowledge Base Search

by levineam · GitHub ↗ · v1.1.0
darwinlinux ✓ Security Clean
3402
Downloads
7
Stars
18
Active Installs
1
Versions
Install in OpenClaw
/install qmd-external
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 what it says: a local Markdown search wrapper around the qmd binary. Before installing and using it, consider: (1) the install command pulls code from the qmd GitHub repo — review/trust the repo before running bun install -g; (2) on first runs qmd may download GGUF models and write them to ~/.cache/qmd/models (or XDG_CACHE_HOME) — expect network activity and significant disk and memory use if local LLMs are loaded; (3) only index directories you intend to expose to the tool (don’t point it at system or sensitive paths); and (4) if you plan to use scheduled reindexing or keep local models warm, consider running those jobs in an isolated environment or container. If any of the above is a concern, review the upstream project and run qmd manually in a controlled environment before granting the agent permission to invoke it automatically.
Capability Analysis
Type: OpenClaw Skill Name: qmd-external Version: 1.1.0 The skill bundle is classified as benign. It provides instructions for installing and using a local markdown search tool (`qmd`). While it includes instructions to set up a cron job for index maintenance (`qmd update && qmd embed` in SKILL.md), this is a transparent and legitimate function for keeping a local search index current. There is no evidence of intentional harmful behavior such as data exfiltration, unauthorized remote control, or malicious prompt injection against the agent; the agent instructions are focused on guiding the proper use of the `qmd` tool.
Capability Assessment
Purpose & Capability
Name/description match the declared requirements: the skill requires the 'qmd' binary and its SKILL.md documents how to use qmd to index and search local Markdown collections. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
Instructions stay within the scope of indexing and searching local Markdown files, but explicitly instruct the agent to run commands that will: (1) download GGUF models on first run, (2) perform embedding work (which may invoke local LLMs and load models into memory), and (3) optionally create scheduled jobs (cron) that re-index/embeds. These behaviors imply network downloads and persistent disk writes (cache and model files) and potential high CPU/RAM usage; they are expected for this tool but worth noting.
Install Mechanism
No formal install spec in the registry, but SKILL.md includes an install command (bun install -g https://github.com/tobi/qmd). Installing via bun will fetch and run code from the qmd GitHub repo — this is reasonable for an open-source tool but does execute external code, so verify the repository/source before installing.
Credentials
The skill does not request secrets or unrelated environment variables. It references PATH and XDG_CACHE_HOME (for cache location), which are appropriate and proportional to running a local binary that caches models and data.
Persistence & Privilege
The skill does not request always: true and doesn't modify other skills. It suggests optionally scheduling reindexes (cron) which is normal for keeping an index fresh; this is a user-controlled persistence step rather than implicit forced presence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install qmd-external
  3. After installation, invoke the skill by name or use /qmd-external
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Performance-tuned qmd skill: BM25 default, vsearch slow warning, auto-reindex cron, memory_search vs qmd distinction
Metadata
Slug qmd-external
Version 1.1.0
License
All-time Installs 18
Active Installs 18
Total Versions 1
Frequently Asked Questions

What is qmd External Knowledge Base 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 3402 downloads so far.

How do I install qmd External Knowledge Base Search?

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

Is qmd External Knowledge Base Search free?

Yes, qmd External Knowledge Base Search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does qmd External Knowledge Base Search support?

qmd External Knowledge Base Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created qmd External Knowledge Base Search?

It is built and maintained by levineam (@levineam); the current version is v1.1.0.

💬 Comments