Agent-Skills.md

Agent Skills: qmd - Local Document Search

|

UncategorizedID: michaelvessia/nixos-config/qmd

Repository

michaelvessia/nixos-config
MichaelVessia
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/MichaelVessia/nixos-config/tree/HEAD/modules/programs/agents/shared/skills/qmd

Skill Files

Browse the full folder contents for qmd.

Download Skill

Loading file tree…

modules/programs/agents/shared/skills/qmd/SKILL.md

Skill Metadata

Name
qmd
Description
|

qmd - Local Document Search

Semantic + full-text search across local markdown docs using local LLMs.

When to Use

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.

Search Commands

qmd search "query"    # BM25 full-text search
qmd vsearch "query"   # Semantic vector search
qmd query "query"     # Hybrid search with LLM reranking (best quality)

Search Flags

| 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 |

Output Formats

| Flag | Format | |------|--------| | --files | CSV: docid, score, filepath, context | | --json | Structured JSON with snippets | | --csv | Comma-separated values | | --md | Markdown formatting | | --xml | XML structure |

Document Retrieval

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

Collection Management

qmd collection list           # View all collections
qmd collection add ~/notes --name notes
qmd ls notes                  # List files in collection
qmd status                    # Index health

Examples

# 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

Workflow

  1. Use qmd collection list to see available collections
  2. Use qmd query for best search quality (uses LLM reranking)
  3. Use --full when you need complete document content
  4. Use qmd get to retrieve specific documents by path or ID

Quick Start for Common Requests

| 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" |