← Back to Skills Marketplace
Qmd 1.0.0
by
instant-picture
· GitHub ↗
· v1.0.0
1867
Downloads
3
Stars
16
Active Installs
1
Versions
Install in OpenClaw
/install qmd-1-0-0
Description
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode.
README (SKILL.md)
qmd
Use qmd to index local files and search them.
Indexing
- Add collection:
qmd collection add /path --name docs --mask "**/*.md" - Update index:
qmd update - Status:
qmd status
Search
- BM25:
qmd search "query" - Vector:
qmd vsearch "query" - Hybrid:
qmd query "query" - Get doc:
qmd get docs/path.md:10 -l 40
Notes
- Embeddings/rerank use Ollama at
OLLAMA_URL(defaulthttp://localhost:11434). - Index lives under
~/.cache/qmdby default. - MCP mode:
qmd mcp.
Usage Guidance
This skill appears to do what it says: it runs the qmd CLI to index and search local files. Before installing or using it: 1) Inspect the GitHub repository (https://github.com/tobi/qmd) or package contents to verify there is no unexpected behavior in the qmd binary. 2) Be deliberate about which directories you index — do not point it at sensitive system or credential directories. 3) Note the index is stored in ~/.cache/qmd; consider its permissions and clean-up policy. 4) Embeddings/rerank use OLLAMA_URL (default localhost:11434). Ensure OLLAMA_URL is set to a trusted local service — if you point it to a remote endpoint you may transmit document contents off-host. 5) Prefer running the tool in a sandbox or non-privileged account until you are comfortable with its behavior.
Capability Analysis
Type: OpenClaw Skill
Name: qmd-1-0-0
Version: 1.0.0
The skill bundle defines the installation and usage of a local search/indexing CLI tool named 'qmd'. The installation instructions in SKILL.md direct the agent to install a Node.js package from a legitimate GitHub repository (https://github.com/tobi/qmd) associated with Tobi Lutke. All described commands are for local file operations and interaction with a local Ollama instance. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection attempts against the agent within the provided files.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions and required binary: the skill expects a 'qmd' CLI and its commands (index, search, mcp) align with the stated local search/indexing purpose. The declared install produces the 'qmd' binary from the linked GitHub repo, which is appropriate for the stated capability.
Instruction Scope
SKILL.md only instructs the agent to run qmd commands (add collection, update, search, get). It documents where the index lives (~/.cache/qmd) and that embeddings/rerank use OLLAMA_URL (default http://localhost:11434). This is in-scope for a search tool, but it means indexed file contents may be sent to whatever OLLAMA_URL is set to; the SKILL.md mentions the env var but the skill does not declare it in requires.env.
Install Mechanism
Install is a node package pointing to a GitHub repo (https://github.com/tobi/qmd). Using a GitHub URL is common and lower risk than arbitrary downloads, but it is less vetted than an official registry release; you should inspect the repository release/packaging before installing.
Credentials
The skill declares no required environment variables, which is reasonable. However SKILL.md references OLLAMA_URL for embeddings/rerank (defaulting to localhost). That env var is relevant to the functionality but is not declared as required; if OLLAMA_URL points to a remote service, document contents could be transmitted off-host — this is a configuration/privacy consideration rather than an incoherence.
Persistence & Privilege
The skill does not request persistent platform privileges (always:false) and does not declare modifications to other skills or system-wide config. It does create and use a local index (~/.cache/qmd), which is expected for this tool and should be treated as potentially sensitive data.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qmd-1-0-0 - After installation, invoke the skill by name or use
/qmd-1-0-0 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of qmd: a local search and indexing CLI tool.
- Supports file indexing with collection management and update commands.
- Provides search with BM25, vector, and hybrid (rerank) modes.
- Integrates with Ollama for embedding and rerank functionality.
- Includes MCP mode for additional functionality.
- Default index storage at ~/.cache/qmd.
Metadata
Frequently Asked Questions
What is Qmd 1.0.0?
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode. It is an AI Agent Skill for Claude Code / OpenClaw, with 1867 downloads so far.
How do I install Qmd 1.0.0?
Run "/install qmd-1-0-0" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Qmd 1.0.0 free?
Yes, Qmd 1.0.0 is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Qmd 1.0.0 support?
Qmd 1.0.0 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Qmd 1.0.0?
It is built and maintained by instant-picture (@instant-picture); the current version is v1.0.0.
More Skills