Agent skill
qmd
Search Tim's Obsidian vault with semantic and keyword search via qmd.
Install this agent skill to your Project
npx add-skill https://github.com/timkrase/clawdis-skills/tree/main/qmd
Metadata
Additional technical details for this skill
- clawdis
-
{ "emoji": "\ud83d\udd0d", "requires": { "bins": [ "qmd" ] } }
SKILL.md
QMD - Vault Search
Search Tim's Obsidian vault (Second Brain) using qmd — combines BM25 keyword search, vector semantic search, and LLM reranking.
When to Use
- Tim asks about something that might be in his notes
- Looking up personal preferences, past decisions, documentation
- Finding specific notes or topics in the vault
- Any question about "what did I write about X"
Quick Commands
# Set PATH first (required!)
export PATH="$HOME/.bun/bin:$PATH"
# Fast keyword search
qmd search "query" -n 5
# Semantic search (understands meaning)
qmd vsearch "how to deploy" -n 5
# Best quality: hybrid + reranking
qmd query "quarterly planning" -n 5
# Search in vault collection specifically
qmd search "API" -c vault
# Get a specific document
qmd get "vault/path/to/note.md"
# Get by docid (from search results)
qmd get "#abc123"
# List all files in vault
qmd ls vault
Output Formats
# Default: human readable snippets
qmd search "query"
# JSON for parsing
qmd search "query" --json
# Just file paths with scores
qmd search "query" --files
# Full document content
qmd search "query" --full
Collections
Currently indexed:
- vault — Tim's Obsidian vault (
/home/clawdis/clawd/obsidian-vault)
Updating the Index
export PATH="$HOME/.bun/bin:$PATH"
# Re-index after vault changes
qmd update
# Update with git pull first
qmd update --pull
# Regenerate embeddings
qmd embed
Tips
- Start with
searchfor exact terms, usevsearchorqueryfor concepts - Use
-n 10if you need more results - Use
--fullto get complete document content - Check
qmd statusto see index health
Example Workflow
export PATH="$HOME/.bun/bin:$PATH"
# Tim asks "what series do I like?"
qmd search "Streaming Serien" -n 3
# Tim asks "how do I deploy to production?"
qmd query "deployment process production" -n 5 --full
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
timkrase/clawdis-skills
football
European football matches — upcoming games, results, and highlights for briefings.
timkrase/clawdis-skills
db-bahn
Query Deutsche Bahn train connections and prices.
timkrase/clawdis-skills
decide
Decision helper — coin flip, dice roll, pick from options, Magic 8-Ball.
mattpocock/skills
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
mattpocock/skills
handoff
Compact the current conversation into a handoff document for another agent to pick up.
mattpocock/skills
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?