← Back to Skills Marketplace
Qmd Skill Main
by
Patrick Maeter
· GitHub ↗
· v1.0.0
1921
Downloads
1
Stars
8
Active Installs
1
Versions
Install in OpenClaw
/install qmd-skill-main
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 do what it says: index and search local Markdown using the qmd CLI. Before installing, verify you trust the qmd GitHub source (the SKILL suggests installing via Bun from the repo), and prefer installing through your package manager or official releases if available. Be aware qmd may download local GGUF models automatically (large disk and network usage) and will read any files you add to its collections — only index directories you intend to expose to the tool. Finally, install Bun/SQLite if you plan to follow the SKILL.md instructions, and confirm the qmd binary on PATH is the expected one.
Capability Analysis
Type: OpenClaw Skill
Name: qmd-skill-main
Version: 1.0.0
The skill bundle is classified as benign. All instructions in SKILL.md, including the installation command `bun install -g https://github.com/tobi/qmd` and subsequent usage examples, are directly aligned with the stated purpose of providing local hybrid search for markdown notes using the 'qmd' tool. There is no evidence of intentional harmful behavior such as data exfiltration, unauthorized execution of arbitrary code, persistence mechanisms for malicious payloads, or prompt injection attempts designed to subvert the agent's core function or access unrelated sensitive data. The cron examples provided are for maintaining the tool's index, not for malicious persistence.
Capability Assessment
Purpose & Capability
The skill's name/description (local hybrid search of markdown notes) matches what the SKILL.md instructs (qmd search/vsearch/query against indexed local collections). Required binaries list only 'qmd', which is appropriate, but the docs also call out prerequisites (Bun >=1.0.0, sqlite on macOS) and an install method that uses Bun to pull the project — those prerequisites are mentioned in the instructions but not declared in the registry 'required binaries' list, a minor inconsistency to be aware of.
Instruction Scope
SKILL.md only instructs use of the qmd CLI to index and search user-specified local Markdown paths, manage indexes, and schedule updates. It does not direct the agent to read unrelated system files, exfiltrate data, or access unrelated credentials. It does mention automatic model downloads and a default cache path (~/.cache/qmd/models/) which are expected for local embedding workflows.
Install Mechanism
The registry lists no formal install spec, but SKILL.md and embedded metadata recommend 'bun install -g https://github.com/tobi/qmd'. Installing from a GitHub repo via Bun is common but executes unreviewed code during installation — a moderate-risk install pattern compared with a vetted package/release. Also the tool may auto-download GGUF models from the network on first run (large files, remote sources).
Credentials
The skill declares no required environment variables or credentials, and SKILL.md only references expected env items like PATH and XDG_CACHE_HOME for cache override. No sensitive credentials are requested, and the scope of environment access (local files for indexing, cache for models) is proportionate to the stated purpose.
Persistence & Privilege
The skill does not request always: true or other elevated persistent privileges in the registry. It is an instruction-only skill that relies on the qmd binary; it does not attempt to force permanent inclusion or autonomous invocation beyond normal agent behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qmd-skill-main - After installation, invoke the skill by name or use
/qmd-skill-main - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
qmd-skill-main 1.0.0
- Initial release of the qmd skill for local hybrid search in markdown notes and documents.
- Supports fast BM25 keyword search (`qmd search`), semantic similarity (`qmd vsearch`), and hybrid reranked results (`qmd query`).
- Easy integration with Bun package manager; includes setup and maintenance instructions.
- Optimized for "messy" markdown and fast collection updates.
- Designed to complement Clawdbot memory search by indexing and querying user-managed local document collections.
Metadata
Frequently Asked Questions
What is Qmd Skill Main?
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 1921 downloads so far.
How do I install Qmd Skill Main?
Run "/install qmd-skill-main" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Qmd Skill Main free?
Yes, Qmd Skill Main is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Qmd Skill Main support?
Qmd Skill Main is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Qmd Skill Main?
It is built and maintained by Patrick Maeter (@pmaeter); the current version is v1.0.0.
More Skills