# Send QMD Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "anshumanbh-qmd",
    "name": "QMD Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/anshumanbh/anshumanbh-qmd",
    "canonicalUrl": "https://clawhub.ai/anshumanbh/anshumanbh-qmd",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/anshumanbh-qmd",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=anshumanbh-qmd",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/anshumanbh-qmd"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/anshumanbh-qmd",
    "downloadUrl": "https://openagent3.xyz/downloads/anshumanbh-qmd",
    "agentUrl": "https://openagent3.xyz/skills/anshumanbh-qmd/agent",
    "manifestUrl": "https://openagent3.xyz/skills/anshumanbh-qmd/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/anshumanbh-qmd/agent.md"
  }
}
```
## Documentation

### QMD Search Skill

Search markdown knowledge bases efficiently using qmd, a local indexing tool that uses BM25 + vector embeddings to return only relevant snippets instead of full files.

### Why Use This

96% token reduction - Returns relevant snippets instead of reading entire files
Instant results - Pre-indexed content means fast searches
Local & private - All indexing and search happens locally
Hybrid search - BM25 for keyword matching, vector search for semantic similarity

### Search (BM25 keyword matching)

qmd search "your query" --collection <name>

Fast, accurate keyword-based search. Best for specific terms or phrases.

### Vector Search (semantic)

qmd vsearch "your query" --collection <name>

Semantic similarity search. Best for conceptual queries where exact words may vary.

### Hybrid Search (both + reranking)

qmd hybrid "your query" --collection <name>

Combines both approaches with LLM reranking. Most thorough but often overkill.

### How to Use

Check if collection exists:
qmd collection list



Search the collection:
# For specific terms
qmd search "api authentication" --collection notes

# For conceptual queries
qmd vsearch "how to handle errors gracefully" --collection notes



Read results: qmd returns relevant snippets with file paths and context

### Setup (if qmd not installed)

# Install qmd
bun install -g https://github.com/tobi/qmd

# Add a collection (e.g., Obsidian vault)
qmd collection add ~/path/to/vault --name notes

# Generate embeddings for vector search
qmd embed --collection notes

### Invocation Examples

/qmd api authentication          # BM25 search for "api authentication"
/qmd how to handle errors --semantic   # Vector search for conceptual query
/qmd --setup                     # Guide through initial setup

### Best Practices

Use BM25 search (qmd search) for specific terms, names, or technical keywords
Use vector search (qmd vsearch) when looking for concepts where wording may vary
Avoid hybrid search unless you need maximum recall - it's slower
Re-run qmd embed after adding significant new content to keep vectors current

### Handling Arguments

$ARGUMENTS contains the full search query
If --semantic flag is present, use qmd vsearch instead of qmd search
If --setup flag is present, guide user through installation and collection setup
If --collection <name> is specified, use that collection; otherwise default to checking available collections

### Workflow

Parse arguments from $ARGUMENTS
Check if qmd is installed (which qmd)
If not installed, offer to guide setup
If searching:

List collections if none specified
Run appropriate search command
Present results to user with file paths


If user wants to read a specific result, use the Read tool on the file path
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: anshumanbh
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/anshumanbh-qmd)
- [Send to Agent page](https://openagent3.xyz/skills/anshumanbh-qmd/agent)
- [JSON manifest](https://openagent3.xyz/skills/anshumanbh-qmd/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/anshumanbh-qmd/agent.md)
- [Download page](https://openagent3.xyz/downloads/anshumanbh-qmd)