qmd
Fast local search for markdown files, notes, and docs using qmd CLI. Use instead of `find` for file discovery. Combines BM25 full-text search, vector semantic search, and LLM reranking—all running locally. Use when searching for files, finding code, locating documentation, or discovering content in indexed collections.
Packaged view
This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.
Install command
npx @skill-hub/cli install openclaw-skills-qmd-local-search
Repository
Skill path: skills/bheemreddy181/qmd-local-search
Fast local search for markdown files, notes, and docs using qmd CLI. Use instead of `find` for file discovery. Combines BM25 full-text search, vector semantic search, and LLM reranking—all running locally. Use when searching for files, finding code, locating documentation, or discovering content in indexed collections.
Open repositoryBest for
Primary workflow: Research & Ops.
Technical facets: Full Stack, Tech Writer.
Target audience: everyone.
License: Unknown.
Original source
Catalog source: SkillHub Club.
Repository owner: openclaw.
This is still a mirrored public skill entry. Review the repository before installing into production workflows.
What it helps with
- Install qmd into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
- Review https://github.com/openclaw/skills before adding qmd to shared team environments
- Use qmd for development workflows
Works across
Favorites: 0.
Sub-skills: 0.
Aggregator: No.
Original source / Raw SKILL.md
---
name: qmd
description: Fast local search for markdown files, notes, and docs using qmd CLI. Use instead of `find` for file discovery. Combines BM25 full-text search, vector semantic search, and LLM reranking—all running locally. Use when searching for files, finding code, locating documentation, or discovering content in indexed collections.
---
# qmd — Fast Local Markdown Search
## When to Use
- **Finding files** — use instead of `find` across large directories (avoids hangs)
- **Searching notes/docs** — semantic or keyword search in indexed collections
- **Code discovery** — find implementations, configs, or patterns
- **Context gathering** — pull relevant snippets before answering questions
## Quick Reference
### Search (most common)
```bash
# Keyword search (BM25)
qmd search "alpaca API" -c projects
# Semantic search (understands meaning)
qmd vsearch "how to implement stop loss"
# Combined search with reranking (best quality)
qmd query "trading rules for breakouts"
# File paths only (fast discovery)
qmd search "config" --files -c kell
# Full document content
qmd search "pattern detection" --full --line-numbers
```
### Collections
```bash
# List collections
qmd collection list
# Add new collection
qmd collection add /path/to/folder --name myproject --mask "*.md,*.py"
# Re-index after changes
qmd update
```
### Get Files
```bash
# Get full file
qmd get myproject/README.md
# Get specific lines
qmd get myproject/config.py:50 -l 30
# Get multiple files by glob
qmd multi-get "*.yaml" -l 50 --max-bytes 10240
```
### Output Formats
- `--files` — paths + scores (for file discovery)
- `--json` — structured with snippets
- `--md` — markdown formatted
- `-n 10` — limit results
## Tips
1. **Always use collections** (`-c name`) to scope searches
2. **Run `qmd update`** after adding new files
3. **Use `qmd embed`** to enable vector search (one-time, takes a few minutes)
4. **Prefer `qmd search --files`** over `find` for large directories
## Models (auto-downloaded)
- Embedding: embeddinggemma-300M
- Reranking: qwen3-reranker-0.6b
- Generation: Qwen3-0.6B
All run locally — no API keys needed.
---
## Skill Companion Files
> Additional files collected from the skill directory layout.
### _meta.json
```json
{
"owner": "bheemreddy181",
"slug": "qmd-local-search",
"displayName": "qmd Local Search",
"latest": {
"version": "1.0.0",
"publishedAt": 1769486363188,
"commit": "https://github.com/clawdbot/skills/commit/941aab8e93a18293b513aa46ef0f227ad1d7ac0d"
},
"history": []
}
```