modules/programs/agents/shared/skills/qmd/SKILL.md
Local semantic search for docs, notes, knowledge bases. INVOKE THIS SKILL when user: - Asks to "search my notes/docs/vault/obsidian" - Wants to "find" something in their knowledge base - Says "what did I write about X" - Asks "do I have notes on X" - Needs context from their local markdown files - Mentions "qmd" directly - Asks about journal entries, meeting notes, or personal documentation Trigger phrases: "search notes", "find in docs", "search obsidian", "what do my notes say", "look in my vault"
npx skillsauth add MichaelVessia/nixos-config qmdInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Semantic + full-text search across local markdown docs using local LLMs.
Use qmd when the user wants to search their personal notes, documentation, or knowledge base. This includes Obsidian vaults, markdown notes directories, and any indexed collections.
qmd search "query" # BM25 full-text search
qmd vsearch "query" # Semantic vector search
qmd query "query" # Hybrid search with LLM reranking (best quality)
| Flag | Purpose |
|------|---------|
| -n <num> | Limit results (default: 5) |
| -c, --collection | Restrict to specific collection |
| --all | Return all matches |
| --min-score <num> | Filter by relevance threshold |
| --full | Display complete document content |
| --line-numbers | Include line numbers |
| Flag | Format |
|------|--------|
| --files | CSV: docid, score, filepath, context |
| --json | Structured JSON with snippets |
| --csv | Comma-separated values |
| --md | Markdown formatting |
| --xml | XML structure |
qmd get "path/to/doc.md" # Get specific document
qmd get "#abc123" # Get by document ID
qmd multi-get "journals/*.md" # Get multiple docs by glob
qmd collection list # View all collections
qmd collection add ~/notes --name notes
qmd ls notes # List files in collection
qmd status # Index health
# High-quality search with reranking
qmd query -n 10 "API design patterns"
# Full document content for LLM context
qmd search --md --full "error handling"
# Search specific collection
qmd search "meeting notes" -c work
qmd collection list to see available collectionsqmd query for best search quality (uses LLM reranking)--full when you need complete document contentqmd get to retrieve specific documents by path or ID| User says | Run this |
|-----------|----------|
| "search my notes for X" | qmd query "X" |
| "what did I write about X" | qmd query --full "X" |
| "find meeting notes about X" | qmd search -c obsidian "meeting X" |
| "show me my notes on X" | qmd query -n 3 --full "X" |
tools
User guide for the local squash-safe `stack` CLI for stacked PR/MR repair on GitHub and GitLab. Use when someone asks how to inspect, track, sync, merge, document, or undo stacked pull requests / merge requests in squash-merge repositories. Prefer this tool over GitHub's `gh stack` command for this workflow.
tools
Control herdr from inside it. Manage workspaces and tabs, split panes, spawn agents, read output, and wait for state changes — all via CLI commands that talk to the running herdr instance over a local unix socket. Use when running inside herdr (HERDR_ENV=1).
development
Inspect my self-hosted AutoCaliWeb library. Use when the user asks about AutoCaliWeb, books in Calibre, OPDS status, recent imports, shelves, catalog stats, or wants to search the ebook library.
data-ai
Subscribe a YouTube channel in TubeArchivist, queue its top videos by views from recent uploads, wait for the first file, scan Jellyfin, and rename + lock the channel folder to a friendly display name. Use when the user says "add a youtube channel", "subscribe to <channel>", or wants a curated TubeArchivist + Jellyfin import for a creator.