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" |
development
Restate the last message in plain human language, with no jargon.
testing
Fan out a batch of work items into one PR each via isolated worktree agents, review every PR before it opens, then babysit all PRs through green CI and review feedback. Use when the user wants to fan out PRs, dispatch parallel PR agents over a list of items, or run a batch of independent changes as separate PRs.
development
Dispatch user-visible coding or research agents through Herdr with Codex-Desktop-like thread ergonomics. Use when the user asks to use Herdr to spawn, dispatch, fan out, inspect, follow up with, or monitor agent workspaces/threads.
development
Generate self-contained HTML visualizations with Plannotator theming. Use for implementation plans, PR explainers, architecture diagrams, data tables, slide decks, and any visual explanation of technical concepts. Plans and PR explainers follow Plannotator's prescriptive approach; all other visual content delegates to nicobailon/visual-explainer.