Agent skill
qmd
Search Tim's Obsidian vault with semantic and keyword search via qmd.
Stars
0
Forks
0
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
bash
# 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
bash
# 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
bash
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
bash
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
Didn't find tool you were looking for?