qmd Documentation Search

Use this skill when searching repository Markdown, notes, or documentation.

Safety boundary

qmd is optional and is not installed by Codomyrmex. Do not install it, download embedding or reranking models, create an index, or modify a user's qmd collections without explicit authorization. These operations may consume substantial disk space and network bandwidth.

Search procedure

1. From the repository root, check whether qmd is available:

   command -v qmd

2. If it is available, inspect configured collections before querying:

   qmd collection list

3. Query only an existing collection whose scope matches the request. Start with lexical search; use hybrid or semantic search only when the installed qmd version supports it and the broader retrieval is useful.

4. If qmd is absent or no suitable collection exists, use the repository-native fallback:

   rg --files -g '*.md'
   rg -n -i 'search terms' -g '*.md' .

5. Open only the relevant files and verify claims against current source, generated receipts, or authoritative documentation before editing.

Output expectations

• Report the search scope and whether qmd or rg supplied the results.
• Treat search results as discovery evidence, not proof that a document is current.
• Preserve the dirty worktree and the documentation hand-pass freeze.