← Back to Skills Marketplace
aryannate

Qmd

by Aryan Nate · GitHub ↗ · v0.1.0
darwinlinux ⚠ suspicious
634
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install qmd-skill-4
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 coherent and implements a local markdown search: it will read and index whatever files you point it at (so avoid indexing secrets), and it may download and store local model files (GGUF) to ~/.cache/qmd/models/ and load them into memory for semantic search which can be slow and resource-heavy. Installing qmd as suggested (bun install -g from GitHub) will execute third-party code — review the upstream repository before installing. If you plan to automate indexing (cron or agent scheduler), restrict the collection paths and run with a user account with limited privileges. If you have sensitive notes, either exclude those paths or run qmd in a sandboxed environment. Overall the skill is internally consistent with its stated purpose, but verify the upstream qmd project and its model-download/network behavior before installing.
Capability Analysis
Type: OpenClaw Skill Name: qmd-skill-4 Version: 0.1.0 The skill instructs the agent to install the `qmd` tool globally from an external GitHub repository (`https://github.com/tobi/qmd`) via `bun install -g` in `SKILL.md`. While this action is necessary for the skill's stated purpose, it introduces a supply chain vulnerability, as the integrity of the external repository is not guaranteed and could be compromised to deliver malicious payloads. The skill also involves extensive local file system interaction and shell command execution, which are powerful capabilities that, while plausible for a local search tool, could be misused if the agent were prompted to do so.
Capability Assessment
Purpose & Capability
Name/description (local hybrid search for markdown) match the declared requirement (qmd binary) and the SKILL.md commands (qmd search, vsearch, query, embed, update, etc.). There are no unrelated credentials, binaries, or config paths requested.
Instruction Scope
Instructions direct the agent to run qmd commands and to index and read user-specified markdown files (e.g., qmd collection add /path/to/notes). This is expected for a local search tool. SKILL.md also states that qmd will auto-download GGUF models to ~/.cache/qmd/models/ and may load local LLMs for semantic search (vsearch/query), which implies network downloads, substantial disk usage, and high memory when models are loaded — an expected but important side effect to be aware of.
Install Mechanism
The skill is instruction-only (no packaged install spec in the registry), but SKILL.md suggests installing qmd via Bun (bun install -g https://github.com/tobi/qmd). Installing from a public GitHub repo via Bun is a common pattern but carries the usual moderate risk of executing third-party code from upstream; the instruction is not using obscure hosts or shorteners. Registry/metadata mismatch: registry listed no install spec while SKILL.md contains install instructions — benign but slightly inconsistent.
Credentials
The skill requests no credentials or special env vars. It mentions PATH and XDG_CACHE_HOME only for practical setup and cache override. No disproportionate secret access is requested.
Persistence & Privilege
always is false and the skill does not request persistent/global agent privileges. SKILL.md suggests optionally running recurring index/embed jobs (cron) — this is user-controlled and not enforced by the skill. The skill does not modify other skills or agent-wide config.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install qmd-skill-4
  3. After installation, invoke the skill by name or use /qmd-skill-4
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of the qmd skill: local hybrid search for Markdown notes and documents. - Provides fast BM25 keyword search by default; semantic and hybrid search available as fallback. - Guides installation and setup, with support for Bun and macOS/Linux. - Documents search commands, retrieval options, and result formatting. - Describes performance trade-offs and best practices for keeping indexes up to date. - Notes how qmd complements Clawdbot’s agent memory search by indexing user files.
Metadata
Slug qmd-skill-4
Version 0.1.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Qmd?

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 634 downloads so far.

How do I install Qmd?

Run "/install qmd-skill-4" 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 (open-source). 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 (darwin, linux).

Who created Qmd?

It is built and maintained by Aryan Nate (@aryannate); the current version is v0.1.0.

💬 Comments