{"skill":{"slug":"k2ljl-qmd","displayName":"QMD Markdown Search","summary":"Search and retrieve markdown documents from local knowledge bases using qmd. Supports BM25 keyword search, vector semantic search, and hybrid search with LLM...","description":"---\nname: qmd\ndescription: Search and retrieve markdown documents from local knowledge bases using qmd. Supports BM25 keyword search, vector semantic search, and hybrid search with LLM re-ranking. Use for querying indexed notes, documentation, meeting transcripts, and any markdown-based knowledge. Requires qmd CLI installed (bun install -g https://github.com/tobi/qmd).\n---\n\n# QMD - Local Markdown Search\n\nSearch and retrieve documents from locally indexed markdown knowledge bases.\n\n## Installation\n\n```bash\nbun install -g https://github.com/tobi/qmd\n```\n\n## Setup\n\n```bash\n# Add a collection\nqmd collection add ~/notes --name notes --mask \"**/*.md\"\n\n# Generate embeddings (required for vsearch/query)\nqmd embed\n```\n\n## Usage Rules\n\n**Always use `--json` flag** for structured output when invoking qmd commands.\n\n## Search Commands\n\n### search (BM25 keyword search - fast)\n\n```bash\nqmd search \"authentication flow\" --json\nqmd search \"error handling\" --json -n 10\nqmd search \"config\" --json -c notes\n```\n\n### vsearch (vector semantic search)\n\n```bash\nqmd vsearch \"how does login work\" --json\nqmd vsearch \"authentication best practices\" --json -n 20\n```\n\n### query (hybrid with LLM re-ranking - best quality)\n\n```bash\nqmd query \"implementing user auth\" --json\nqmd query \"deployment process\" --json --min-score 0.5\n```\n\n### Search Options\n\n| Option | Description |\n|--------|-------------|\n| `-n NUM` | Number of results (default: 5, or 20 with --json) |\n| `-c, --collection NAME` | Restrict to specific collection |\n| `--min-score NUM` | Minimum score threshold |\n| `--full` | Return complete document content in results |\n| `--all` | Return all matches |\n\n## Retrieval Commands\n\n### get (single document)\n\n```bash\nqmd get docs/guide.md --json\nqmd get \"#a1b2c3\" --json\nqmd get notes/meeting.md:50 -l 100 --json\n```\n\n### multi-get (multiple documents)\n\n```bash\nqmd multi-get \"docs/*.md\" --json\nqmd multi-get \"api.md, guide.md, #abc123\" --json\nqmd multi-get \"notes/**/*.md\" --json --max-bytes 20480\n```\n\n## Maintenance Commands\n\n```bash\nqmd update              # Re-index changed files\nqmd status              # Check index health\nqmd collection list     # List all collections\n```\n\n## Search Mode Selection\n\n| Mode | Speed | Quality | Best For |\n|------|-------|---------|----------|\n| search | Fast | Good | Exact keywords, known terms |\n| vsearch | Medium | Better | Conceptual queries, synonyms |\n| query | Slow | Best | Complex questions, uncertain terms |\n\n**Performance note:** `vsearch` and `query` have ~1 minute cold start latency for vector initialization. Prefer `search` for interactive use.\n\n## MCP Server\n\nqmd can run as an MCP server for direct integration:\n\n```bash\nqmd mcp\n```\n\nExposes tools: `qmd_search`, `qmd_vsearch`, `qmd_query`, `qmd_get`, `qmd_multi_get`, `qmd_status`\n","topics":["Documentation"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":635,"installsAllTime":24,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773629955716,"updatedAt":1778491936802},"latestVersion":{"version":"1.0.0","createdAt":1773629955716,"changelog":"QMD Skill 1.0.0 – Initial Release\n\n- Search local markdown knowledge bases using fast BM25 keyword, vector semantic, or hybrid LLM-re-ranked methods.\n- Retrieve individual or multiple markdown documents by path or ID.\n- All commands support structured --json output for integration.\n- Easy setup instructions for indexing and embedding content.\n- Includes maintenance commands for updating and checking collection health.\n- Supports MCP server mode for tool integration: search, vsearch, query, get, multi-get, and status.","license":"MIT-0"},"metadata":null,"owner":{"handle":"davidsteelerose","userId":"s174qyqm608kg059g9baqs95m587csfk","displayName":"davidsteelerose","image":"https://avatars.githubusercontent.com/u/1289381?v=4"},"moderation":null}