[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MF5EFY6MEPX98Q9M5PRQP6":3,"skill-same:01M6MF5EFY6MEPX98Q9M5PRQP6":85},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":64,"commitSha":65,"skillDirectory":66,"forksCount":67,"repositoryHtmlUrl":68,"repositoryHomepageUrl":6,"ownerHtmlUrl":69,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":70,"install":71,"resources":84},"01M6MF5EFY6MEPX98Q9M5PRQP6","qmd",null,"Search personal knowledge bases, notes, docs, and meeting transcripts locally using qmd — a hybrid retrieval engine with BM25, vector search, and LLM reranking. Supports CLI and MCP integration.","ibragimov-oasis\u002Fvibe-coder","ibragimov-oasis","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F240665573?v=4","01M6DF78Y45R8228FHAZ7G6JXM","IBRAGIMOV MUKHAMMADJON","01M6K5ZYR8TDPAFG4R6693E2A6",3,"MIT","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002FREPO_DOCS\u002F02-hermes-agent\u002Foptional-skills\u002Fresearch\u002Fqmd\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[5,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"knowledge","hybrid","meeting","transcripts","bm25","knowledge-base","local","hermes agent","hermes","engine","MCP","MCP Integration","integration","vector","search","rag","notes","macos","personal","2026-11-10 10:12:30",false,"---\nname: qmd\ndescription: Search personal knowledge bases, notes, docs, and meeting transcripts locally using qmd — a hybrid retrieval engine with BM25, vector search, and LLM reranking. Supports CLI and MCP integration.\nversion: 1.0.0\nauthor: Hermes Agent + Teknium\nlicense: MIT\nplatforms: [macos, linux]\nmetadata:\n  hermes:\n    tags: [Search, Knowledge-Base, RAG, Notes, MCP, Local-AI]\n    related_skills: [obsidian, native-mcp, arxiv]\n---\n\n# QMD — Query Markup Documents\n\nLocal, on-device search engine for personal knowledge bases. Indexes markdown\nnotes, meeting transcripts, documentation, and any text-based files, then\nprovides hybrid search combining keyword matching, semantic understanding, and\nLLM-powered reranking — all running locally with no cloud dependencies.\n\nCreated by [Tobi Lütke](https:\u002F\u002Fgithub.com\u002Ftobi\u002Fqmd). MIT licensed.\n\n## When to Use\n\n- User asks to search their notes, docs, knowledge base, or meeting transcripts\n- User wants to find something across a large collection of markdown\u002Ftext files\n- User wants semantic search (\"find notes about X concept\") not just keyword grep\n- User has already set up qmd collections and wants to query them\n- User asks to set up a local knowledge base or document search system\n- Keywords: \"search my notes\", \"find in my docs\", \"knowledge base\", \"qmd\"\n\n## Prerequisites\n\n### Node.js >= 22 (required)\n\n```bash\n# Check version\nnode --version  # must be >= 22\n\n# macOS — install or upgrade via Homebrew\nbrew install node@22\n\n# Linux — use NodeSource or nvm\ncurl -fsSL https:\u002F\u002Fdeb.nodesource.com\u002Fsetup_22.x | sudo -E bash -\nsudo apt-get install -y nodejs\n# or with nvm:\nnvm install 22 && nvm use 22\n```\n\n### SQLite with Extension Support (macOS only)\n\nmacOS system SQLite lacks extension loading. Install via Homebrew:\n\n```bash\nbrew install sqlite\n```\n\n### Install qmd\n\n```bash\nnpm install -g @tobilu\u002Fqmd\n# or with Bun:\nbun install -g @tobilu\u002Fqmd\n```\n\nFirst run auto-downloads 3 local GGUF models (~2GB total):\n\n| Model | Purpose | Size |\n|-------|---------|------|\n| embeddinggemma-300M-Q8_0 | Vector embeddings | ~300MB |\n| qwen3-reranker-0.6b-q8_0 | Result reranking | ~640MB |\n| qmd-query-expansion-1.7B | Query expansion | ~1.1GB |\n\n### Verify Installation\n\n```bash\nqmd --version\nqmd status\n```\n\n## Quick Reference\n\n| Command | What It Does | Speed |\n|---------|-------------|-------|\n| `qmd search \"query\"` | BM25 keyword search (no models) | ~0.2s |\n| `qmd vsearch \"query\"` | Semantic vector search (1 model) | ~3s |\n| `qmd query \"query\"` | Hybrid + reranking (all 3 models) | ~2-3s warm, ~19s cold |\n| `qmd get \u003Cdocid>` | Retrieve full document content | instant |\n| `qmd multi-get \"glob\"` | Retrieve multiple files | instant |\n| `qmd collection add \u003Cpath> --name \u003Cn>` | Add a directory as a collection | instant |\n| `qmd context add \u003Cpath> \"description\"` | Add context metadata to improve retrieval | instant |\n| `qmd embed` | Generate\u002Fupdate vector embeddings | varies |\n| `qmd status` | Show index health and collection info | instant |\n| `qmd mcp` | Start MCP server (stdio) | persistent |\n| `qmd mcp --http --daemon` | Start MCP server (HTTP, warm models) | persistent |\n\n## Setup Workflow\n\n### 1. Add Collections\n\nPoint qmd at directories containing your documents:\n\n```bash\n# Add a notes directory\nqmd collection add ~\u002Fnotes --name notes\n\n# Add project docs\nqmd collection add ~\u002Fprojects\u002Fmyproject\u002Fdocs --name project-docs\n\n# Add meeting transcripts\nqmd collection add ~\u002Fmeetings --name meetings\n\n# List all collections\nqmd collection list\n```\n\n### 2. Add Context Descriptions\n\nContext metadata helps the search engine understand what each collection\ncontains. This significantly improves retrieval quality:\n\n```bash\nqmd context add qmd:\u002F\u002Fnotes \"Personal notes, ideas, and journal entries\"\nqmd context add qmd:\u002F\u002Fproject-docs \"Technical documentation for the main project\"\nqmd context add qmd:\u002F\u002Fmeetings \"Meeting transcripts and action items from team syncs\"\n```\n\n### 3. Generate Embeddings\n\n```bash\nqmd embed\n```\n\nThis processes all documents in all collections and generates vector\nembeddings. Re-run after adding new documents or collections.\n\n### 4. Verify\n\n```bash\nqmd status   # shows index health, collection stats, model info\n```\n\n## Search Patterns\n\n### Fast Keyword Search (BM25)\n\nBest for: exact terms, code identifiers, names, known phrases.\nNo models loaded — near-instant results.\n\n```bash\nqmd search \"authentication middleware\"\nqmd search \"handleError async\"\n```\n\n### Semantic Vector Search\n\nBest for: natural language questions, conceptual queries.\nLoads embedding model (~3s first query).\n\n```bash\nqmd vsearch \"how does the rate limiter handle burst traffic\"\nqmd vsearch \"ideas for improving onboarding flow\"\n```\n\n### Hybrid Search with Reranking (Best Quality)\n\nBest for: important queries where quality matters most.\nUses all 3 models — query expansion, parallel BM25+vector, reranking.\n\n```bash\nqmd query \"what decisions were made about the database migration\"\n```\n\n### Structured Multi-Mode Queries\n\nCombine different search types in a single query for precision:\n\n```bash\n# BM25 for exact term + vector for concept\nqmd query $'lex: rate limiter\\nvec: how does throttling work under load'\n\n# With query expansion\nqmd query $'expand: database migration plan\\nlex: \"schema change\"'\n```\n\n### Query Syntax (lex\u002FBM25 mode)\n\n| Syntax | Effect | Example |\n|--------|--------|---------|\n| `term` | Prefix match | `perf` matches \"performance\" |\n| `\"phrase\"` | Exact phrase | `\"rate limiter\"` |\n| `-term` | Exclude term | `performance -sports` |\n\n### HyDE (Hypothetical Document Embeddings)\n\nFor complex topics, write what you expect the answer to look like:\n\n```bash\nqmd query $'hyde: The migration plan involves three phases. First, we add the new columns without dropping the old ones. Then we backfill data. Finally we cut over and remove legacy columns.'\n```\n\n### Scoping to Collections\n\n```bash\nqmd search \"query\" --collection notes\nqmd query \"query\" --collection project-docs\n```\n\n### Output Formats\n\n```bash\nqmd search \"query\" --json        # JSON output (best for parsing)\nqmd search \"query\" --limit 5     # Limit results\nqmd get \"#abc123\"                # Get by document ID\nqmd get \"path\u002Fto\u002Ffile.md\"       # Get by file path\nqmd get \"file.md:50\" -l 100     # Get specific line range\nqmd multi-get \"journals\u002F*.md\" --json  # Batch retrieve by glob\n```\n\n## MCP Integration (Recommended)\n\nqmd exposes an MCP server that provides search tools directly to\nHermes Agent via the native MCP client. This is the preferred\nintegration — once configured, the agent gets qmd tools automatically\nwithout needing to load this skill.\n\n### Option A: Stdio Mode (Simple)\n\nAdd to `~\u002F.hermes\u002Fconfig.yaml`:\n\n```yaml\nmcp_servers:\n  qmd:\n    command: \"qmd\"\n    args: [\"mcp\"]\n    timeout: 30\n    connect_timeout: 45\n```\n\nThis registers tools: `mcp_qmd_search`, `mcp_qmd_vsearch`,\n`mcp_qmd_deep_search`, `mcp_qmd_get`, `mcp_qmd_status`.\n\n**Tradeoff:** Models load on first search call (~19s cold start),\nthen stay warm for the session. Acceptable for occasional use.\n\n### Option B: HTTP Daemon Mode (Fast, Recommended for Heavy Use)\n\nStart the qmd daemon separately — it keeps models warm in memory:\n\n```bash\n# Start daemon (persists across agent restarts)\nqmd mcp --http --daemon\n\n# Runs on http:\u002F\u002Flocalhost:8181 by default\n```\n\nThen configure Hermes Agent to connect via HTTP:\n\n```yaml\nmcp_servers:\n  qmd:\n    url: \"http:\u002F\u002Flocalhost:8181\u002Fmcp\"\n    timeout: 30\n```\n\n**Tradeoff:** Uses ~2GB RAM while running, but every query is fast\n(~2-3s). Best for users who search frequently.\n\n### Keeping the Daemon Running\n\n#### macOS (launchd)\n\n```bash\ncat > ~\u002FLibrary\u002FLaunchAgents\u002Fcom.qmd.daemon.plist \u003C\u003C 'EOF'\n\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003C!DOCTYPE plist PUBLIC \"-\u002F\u002FApple\u002F\u002FDTD PLIST 1.0\u002F\u002FEN\"\n  \"http:\u002F\u002Fwww.apple.com\u002FDTDs\u002FPropertyList-1.0.dtd\">\n\u003Cplist version=\"1.0\">\n\u003Cdict>\n  \u003Ckey>Label\u003C\u002Fkey>\n  \u003Cstring>com.qmd.daemon\u003C\u002Fstring>\n  \u003Ckey>ProgramArguments\u003C\u002Fkey>\n  \u003Carray>\n    \u003Cstring>qmd\u003C\u002Fstring>\n    \u003Cstring>mcp\u003C\u002Fstring>\n    \u003Cstring>--http\u003C\u002Fstring>\n    \u003Cstring>--daemon\u003C\u002Fstring>\n  \u003C\u002Farray>\n  \u003Ckey>RunAtLoad\u003C\u002Fkey>\n  \u003Ctrue\u002F>\n  \u003Ckey>KeepAlive\u003C\u002Fkey>\n  \u003Ctrue\u002F>\n  \u003Ckey>StandardOutPath\u003C\u002Fkey>\n  \u003Cstring>\u002Ftmp\u002Fqmd-daemon.log\u003C\u002Fstring>\n  \u003Ckey>StandardErrorPath\u003C\u002Fkey>\n  \u003Cstring>\u002Ftmp\u002Fqmd-daemon.log\u003C\u002Fstring>\n\u003C\u002Fdict>\n\u003C\u002Fplist>\nEOF\n\nlaunchctl load ~\u002FLibrary\u002FLaunchAgents\u002Fcom.qmd.daemon.plist\n```\n\n#### Linux (systemd user service)\n\n```bash\nmkdir -p ~\u002F.config\u002Fsystemd\u002Fuser\n\ncat > ~\u002F.config\u002Fsystemd\u002Fuser\u002Fqmd-daemon.service \u003C\u003C 'EOF'\n[Unit]\nDescription=QMD MCP Daemon\nAfter=network.target\n\n[Service]\nExecStart=qmd mcp --http --daemon\nRestart=on-failure\nRestartSec=10\nEnvironment=PATH=\u002Fusr\u002Flocal\u002Fbin:\u002Fusr\u002Fbin:\u002Fbin\n\n[Install]\nWantedBy=default.target\nEOF\n\nsystemctl --user daemon-reload\nsystemctl --user enable --now qmd-daemon\nsystemctl --user status qmd-daemon\n```\n\n### MCP Tools Reference\n\nOnce connected, these tools are available as `mcp_qmd_*`:\n\n| MCP Tool | Maps To | Description |\n|----------|---------|-------------|\n| `mcp_qmd_search` | `qmd search` | BM25 keyword search |\n| `mcp_qmd_vsearch` | `qmd vsearch` | Semantic vector search |\n| `mcp_qmd_deep_search` | `qmd query` | Hybrid search + reranking |\n| `mcp_qmd_get` | `qmd get` | Retrieve document by ID or path |\n| `mcp_qmd_status` | `qmd status` | Index health and stats |\n\nThe MCP tools accept structured JSON queries for multi-mode search:\n\n```json\n{\n  \"searches\": [\n    {\"type\": \"lex\", \"query\": \"authentication middleware\"},\n    {\"type\": \"vec\", \"query\": \"how user login is verified\"}\n  ],\n  \"collections\": [\"project-docs\"],\n  \"limit\": 10\n}\n```\n\n## CLI Usage (Without MCP)\n\nWhen MCP is not configured, use qmd directly via terminal:\n\n```\nterminal(command=\"qmd query 'what was decided about the API redesign' --json\", timeout=30)\n```\n\nFor setup and management tasks, always use terminal:\n\n```\nterminal(command=\"qmd collection add ~\u002FDocuments\u002Fnotes --name notes\")\nterminal(command=\"qmd context add qmd:\u002F\u002Fnotes 'Personal research notes and ideas'\")\nterminal(command=\"qmd embed\")\nterminal(command=\"qmd status\")\n```\n\n## How the Search Pipeline Works\n\nUnderstanding the internals helps choose the right search mode:\n\n1. **Query Expansion** — A fine-tuned 1.7B model generates 2 alternative\n   queries. The original gets 2x weight in fusion.\n2. **Parallel Retrieval** — BM25 (SQLite FTS5) and vector search run\n   simultaneously across all query variants.\n3. **RRF Fusion** — Reciprocal Rank Fusion (k=60) merges results.\n   Top-rank bonus: #1 gets +0.05, #2-3 get +0.02.\n4. **LLM Reranking** — qwen3-reranker scores top 30 candidates (0.0-1.0).\n5. **Position-Aware Blending** — Ranks 1-3: 75% retrieval \u002F 25% reranker.\n   Ranks 4-10: 60\u002F40. Ranks 11+: 40\u002F60 (trusts reranker more for long tail).\n\n**Smart Chunking:** Documents are split at natural break points (headings,\ncode blocks, blank lines) targeting ~900 tokens with 15% overlap. Code\nblocks are never split mid-block.\n\n## Best Practices\n\n1. **Always add context descriptions** — `qmd context add` dramatically\n   improves retrieval accuracy. Describe what each collection contains.\n2. **Re-embed after adding documents** — `qmd embed` must be re-run when\n   new files are added to collections.\n3. **Use `qmd search` for speed** — when you need fast keyword lookup\n   (code identifiers, exact names), BM25 is instant and needs no models.\n4. **Use `qmd query` for quality** — when the question is conceptual or\n   the user needs the best possible results, use hybrid search.\n5. **Prefer MCP integration** — once configured, the agent gets native\n   tools without needing to load this skill each time.\n6. **Daemon mode for frequent users** — if the user searches their\n   knowledge base regularly, recommend the HTTP daemon setup.\n7. **First query in structured search gets 2x weight** — put the most\n   important\u002Fcertain query first when combining lex and vec.\n\n## Troubleshooting\n\n### \"Models downloading on first run\"\nNormal — qmd auto-downloads ~2GB of GGUF models on first use.\nThis is a one-time operation.\n\n### Cold start latency (~19s)\nThis happens when models aren't loaded in memory. Solutions:\n- Use HTTP daemon mode (`qmd mcp --http --daemon`) to keep warm\n- Use `qmd search` (BM25 only) when models aren't needed\n- MCP stdio mode loads models on first search, stays warm for session\n\n### macOS: \"unable to load extension\"\nInstall Homebrew SQLite: `brew install sqlite`\nThen ensure it's on PATH before system SQLite.\n\n### \"No collections found\"\nRun `qmd collection add \u003Cpath> --name \u003Cname>` to add directories,\nthen `qmd embed` to index them.\n\n### Embedding model override (CJK\u002Fmultilingual)\nSet `QMD_EMBED_MODEL` environment variable for non-English content:\n```bash\nexport QMD_EMBED_MODEL=\"your-multilingual-model\"\n```\n\n## Data Storage\n\n- **Index & vectors:** `~\u002F.cache\u002Fqmd\u002Findex.sqlite`\n- **Models:** Auto-downloaded to local cache on first run\n- **No cloud dependencies** — everything runs locally\n\n## References\n\n- [GitHub: tobi\u002Fqmd](https:\u002F\u002Fgithub.com\u002Ftobi\u002Fqmd)\n- [QMD Changelog](https:\u002F\u002Fgithub.com\u002Ftobi\u002Fqmd\u002Fblob\u002Fmain\u002FCHANGELOG.md)\n\n## ? Связи\n\n- [[000 - Map of Maps]] — REPO_DOCS\n- [[000 - Map of Maps]] — Map of Maps\n\n","# QMD — Query Markup Documents\n\nLocal, on-device search engine for personal knowledge bases. Indexes markdown\nnotes, meeting transcripts, documentation, and any text-based files, then\nprovides hybrid search combining keyword matching, semantic understanding, and\nLLM-powered reranking — all running locally with no cloud dependencies.\n\nCreated by [Tobi Lütke](https:\u002F\u002Fgithub.com\u002Ftobi\u002Fqmd). MIT licensed.\n\n## When to Use\n\n- User asks to search their notes, docs, knowledge base, or meeting transcripts\n- User wants to find something across a large collection of markdown\u002Ftext files\n- User wants semantic search (\"find notes about X concept\") not just keyword grep\n- User has already set up qmd collections and wants to query them\n- User asks to set up a local knowledge base or document search system\n- Keywords: \"search my notes\", \"find in my docs\", \"knowledge base\", \"qmd\"\n\n## Prerequisites\n\n### Node.js >= 22 (required)\n\n```bash\n# Check version\nnode --version  # must be >= 22\n\n# macOS — install or upgrade via Homebrew\nbrew install node@22\n\n# Linux — use NodeSource or nvm\ncurl -fsSL https:\u002F\u002Fdeb.nodesource.com\u002Fsetup_22.x | sudo -E bash -\nsudo apt-get install -y nodejs\n# or with nvm:\nnvm install 22 && nvm use 22\n```\n\n### SQLite with Extension Support (macOS only)\n\nmacOS system SQLite lacks extension loading. Install via Homebrew:\n\n```bash\nbrew install sqlite\n```\n\n### Install qmd\n\n```bash\nnpm install -g @tobilu\u002Fqmd\n# or with Bun:\nbun install -g @tobilu\u002Fqmd\n```\n\nFirst run auto-downloads 3 local GGUF models (~2GB total):\n\n| Model | Purpose | Size |\n|-------|---------|------|\n| embeddinggemma-300M-Q8_0 | Vector embeddings | ~300MB |\n| qwen3-reranker-0.6b-q8_0 | Result reranking | ~640MB |\n| qmd-query-expansion-1.7B | Query expansion | ~1.1GB |\n\n### Verify Installation\n\n```bash\nqmd --version\nqmd status\n```\n\n## Quick Reference\n\n| Command | What It Does | Speed |\n|---------|-------------|-------|\n| `qmd search \"query\"` | BM25 keyword search (no models) | ~0.2s |\n| `qmd vsearch \"query\"` | Semantic vector search (1 model) | ~3s |\n| `qmd query \"query\"` | Hybrid + reranking (all 3 models) | ~2-3s warm, ~19s cold |\n| `qmd get \u003Cdocid>` | Retrieve full document content | instant |\n| `qmd multi-get \"glob\"` | Retrieve multiple files | instant |\n| `qmd collection add \u003Cpath> --name \u003Cn>` | Add a directory as a collection | instant |\n| `qmd context add \u003Cpath> \"description\"` | Add context metadata to improve retrieval | instant |\n| `qmd embed` | Generate\u002Fupdate vector embeddings | varies |\n| `qmd status` | Show index health and collection info | instant |\n| `qmd mcp` | Start MCP server (stdio) | persistent |\n| `qmd mcp --http --daemon` | Start MCP server (HTTP, warm models) | persistent |\n\n## Setup Workflow\n\n### 1. Add Collections\n\nPoint qmd at directories containing your documents:\n\n```bash\n# Add a notes directory\nqmd collection add ~\u002Fnotes --name notes\n\n# Add project docs\nqmd collection add ~\u002Fprojects\u002Fmyproject\u002Fdocs --name project-docs\n\n# Add meeting transcripts\nqmd collection add ~\u002Fmeetings --name meetings\n\n# List all collections\nqmd collection list\n```\n\n### 2. Add Context Descriptions\n\nContext metadata helps the search engine understand what each collection\ncontains. This significantly improves retrieval quality:\n\n```bash\nqmd context add qmd:\u002F\u002Fnotes \"Personal notes, ideas, and journal entries\"\nqmd context add qmd:\u002F\u002Fproject-docs \"Technical documentation for the main project\"\nqmd context add qmd:\u002F\u002Fmeetings \"Meeting transcripts and action items from team syncs\"\n```\n\n### 3. Generate Embeddings\n\n```bash\nqmd embed\n```\n\nThis processes all documents in all collections and generates vector\nembeddings. Re-run after adding new documents or collections.\n\n### 4. Verify\n\n```bash\nqmd status   # shows index health, collection stats, model info\n```\n\n## Search Patterns\n\n### Fast Keyword Search (BM25)\n\nBest for: exact terms, code identifiers, names, known phrases.\nNo models loaded — near-instant results.\n\n```bash\nqmd search \"authentication middleware\"\nqmd search \"handleError async\"\n```\n\n### Semantic Vector Search\n\nBest for: natural language questions, conceptual queries.\nLoads embedding model (~3s first query).\n\n```bash\nqmd vsearch \"how does the rate limiter handle burst traffic\"\nqmd vsearch \"ideas for improving onboarding flow\"\n```\n\n### Hybrid Search with Reranking (Best Quality)\n\nBest for: important queries where quality matters most.\nUses all 3 models — query expansion, parallel BM25+vector, reranking.\n\n```bash\nqmd query \"what decisions were made about the database migration\"\n```\n\n### Structured Multi-Mode Queries\n\nCombine different search types in a single query for precision:\n\n```bash\n# BM25 for exact term + vector for concept\nqmd query $'lex: rate limiter\\nvec: how does throttling work under load'\n\n# With query expansion\nqmd query $'expand: database migration plan\\nlex: \"schema change\"'\n```\n\n### Query Syntax (lex\u002FBM25 mode)\n\n| Syntax | Effect | Example |\n|--------|--------|---------|\n| `term` | Prefix match | `perf` matches \"performance\" |\n| `\"phrase\"` | Exact phrase | `\"rate limiter\"` |\n| `-term` | Exclude term | `performance -sports` |\n\n### HyDE (Hypothetical Document Embeddings)\n\nFor complex topics, write what you expect the answer to look like:\n\n```bash\nqmd query $'hyde: The migration plan involves three phases. First, we add the new columns without dropping the old ones. Then we backfill data. Finally we cut over and remove legacy columns.'\n```\n\n### Scoping to Collections\n\n```bash\nqmd search \"query\" --collection notes\nqmd query \"query\" --collection project-docs\n```\n\n### Output Formats\n\n```bash\nqmd search \"query\" --json        # JSON output (best for parsing)\nqmd search \"query\" --limit 5     # Limit results\nqmd get \"#abc123\"                # Get by document ID\nqmd get \"path\u002Fto\u002Ffile.md\"       # Get by file path\nqmd get \"file.md:50\" -l 100     # Get specific line range\nqmd multi-get \"journals\u002F*.md\" --json  # Batch retrieve by glob\n```\n\n## MCP Integration (Recommended)\n\nqmd exposes an MCP server that provides search tools directly to\nHermes Agent via the native MCP client. This is the preferred\nintegration — once configured, the agent gets qmd tools automatically\nwithout needing to load this skill.\n\n### Option A: Stdio Mode (Simple)\n\nAdd to `~\u002F.hermes\u002Fconfig.yaml`:\n\n```yaml\nmcp_servers:\n  qmd:\n    command: \"qmd\"\n    args: [\"mcp\"]\n    timeout: 30\n    connect_timeout: 45\n```\n\nThis registers tools: `mcp_qmd_search`, `mcp_qmd_vsearch`,\n`mcp_qmd_deep_search`, `mcp_qmd_get`, `mcp_qmd_status`.\n\n**Tradeoff:** Models load on first search call (~19s cold start),\nthen stay warm for the session. Acceptable for occasional use.\n\n### Option B: HTTP Daemon Mode (Fast, Recommended for Heavy Use)\n\nStart the qmd daemon separately — it keeps models warm in memory:\n\n```bash\n# Start daemon (persists across agent restarts)\nqmd mcp --http --daemon\n\n# Runs on http:\u002F\u002Flocalhost:8181 by default\n```\n\nThen configure Hermes Agent to connect via HTTP:\n\n```yaml\nmcp_servers:\n  qmd:\n    url: \"http:\u002F\u002Flocalhost:8181\u002Fmcp\"\n    timeout: 30\n```\n\n**Tradeoff:** Uses ~2GB RAM while running, but every query is fast\n(~2-3s). Best for users who search frequently.\n\n### Keeping the Daemon Running\n\n#### macOS (launchd)\n\n```bash\ncat > ~\u002FLibrary\u002FLaunchAgents\u002Fcom.qmd.daemon.plist \u003C\u003C 'EOF'\n\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003C!DOCTYPE plist PUBLIC \"-\u002F\u002FApple\u002F\u002FDTD PLIST 1.0\u002F\u002FEN\"\n  \"http:\u002F\u002Fwww.apple.com\u002FDTDs\u002FPropertyList-1.0.dtd\">\n\u003Cplist version=\"1.0\">\n\u003Cdict>\n  \u003Ckey>Label\u003C\u002Fkey>\n  \u003Cstring>com.qmd.daemon\u003C\u002Fstring>\n  \u003Ckey>ProgramArguments\u003C\u002Fkey>\n  \u003Carray>\n    \u003Cstring>qmd\u003C\u002Fstring>\n    \u003Cstring>mcp\u003C\u002Fstring>\n    \u003Cstring>--http\u003C\u002Fstring>\n    \u003Cstring>--daemon\u003C\u002Fstring>\n  \u003C\u002Farray>\n  \u003Ckey>RunAtLoad\u003C\u002Fkey>\n  \u003Ctrue\u002F>\n  \u003Ckey>KeepAlive\u003C\u002Fkey>\n  \u003Ctrue\u002F>\n  \u003Ckey>StandardOutPath\u003C\u002Fkey>\n  \u003Cstring>\u002Ftmp\u002Fqmd-daemon.log\u003C\u002Fstring>\n  \u003Ckey>StandardErrorPath\u003C\u002Fkey>\n  \u003Cstring>\u002Ftmp\u002Fqmd-daemon.log\u003C\u002Fstring>\n\u003C\u002Fdict>\n\u003C\u002Fplist>\nEOF\n\nlaunchctl load ~\u002FLibrary\u002FLaunchAgents\u002Fcom.qmd.daemon.plist\n```\n\n#### Linux (systemd user service)\n\n```bash\nmkdir -p ~\u002F.config\u002Fsystemd\u002Fuser\n\ncat > ~\u002F.config\u002Fsystemd\u002Fuser\u002Fqmd-daemon.service \u003C\u003C 'EOF'\n[Unit]\nDescription=QMD MCP Daemon\nAfter=network.target\n\n[Service]\nExecStart=qmd mcp --http --daemon\nRestart=on-failure\nRestartSec=10\nEnvironment=PATH=\u002Fusr\u002Flocal\u002Fbin:\u002Fusr\u002Fbin:\u002Fbin\n\n[Install]\nWantedBy=default.target\nEOF\n\nsystemctl --user daemon-reload\nsystemctl --user enable --now qmd-daemon\nsystemctl --user status qmd-daemon\n```\n\n### MCP Tools Reference\n\nOnce connected, these tools are available as `mcp_qmd_*`:\n\n| MCP Tool | Maps To | Description |\n|----------|---------|-------------|\n| `mcp_qmd_search` | `qmd search` | BM25 keyword search |\n| `mcp_qmd_vsearch` | `qmd vsearch` | Semantic vector search |\n| `mcp_qmd_deep_search` | `qmd query` | Hybrid search + reranking |\n| `mcp_qmd_get` | `qmd get` | Retrieve document by ID or path |\n| `mcp_qmd_status` | `qmd status` | Index health and stats |\n\nThe MCP tools accept structured JSON queries for multi-mode search:\n\n```json\n{\n  \"searches\": [\n    {\"type\": \"lex\", \"query\": \"authentication middleware\"},\n    {\"type\": \"vec\", \"query\": \"how user login is verified\"}\n  ],\n  \"collections\": [\"project-docs\"],\n  \"limit\": 10\n}\n```\n\n## CLI Usage (Without MCP)\n\nWhen MCP is not configured, use qmd directly via terminal:\n\n```\nterminal(command=\"qmd query 'what was decided about the API redesign' --json\", timeout=30)\n```\n\nFor setup and management tasks, always use terminal:\n\n```\nterminal(command=\"qmd collection add ~\u002FDocuments\u002Fnotes --name notes\")\nterminal(command=\"qmd context add qmd:\u002F\u002Fnotes 'Personal research notes and ideas'\")\nterminal(command=\"qmd embed\")\nterminal(command=\"qmd status\")\n```\n\n## How the Search Pipeline Works\n\nUnderstanding the internals helps choose the right search mode:\n\n1. **Query Expansion** — A fine-tuned 1.7B model generates 2 alternative\n   queries. The original gets 2x weight in fusion.\n2. **Parallel Retrieval** — BM25 (SQLite FTS5) and vector search run\n   simultaneously across all query variants.\n3. **RRF Fusion** — Reciprocal Rank Fusion (k=60) merges results.\n   Top-rank bonus: #1 gets +0.05, #2-3 get +0.02.\n4. **LLM Reranking** — qwen3-reranker scores top 30 candidates (0.0-1.0).\n5. **Position-Aware Blending** — Ranks 1-3: 75% retrieval \u002F 25% reranker.\n   Ranks 4-10: 60\u002F40. Ranks 11+: 40\u002F60 (trusts reranker more for long tail).\n\n**Smart Chunking:** Documents are split at natural break points (headings,\ncode blocks, blank lines) targeting ~900 tokens with 15% overlap. Code\nblocks are never split mid-block.\n\n## Best Practices\n\n1. **Always add context descriptions** — `qmd context add` dramatically\n   improves retrieval accuracy. Describe what each collection contains.\n2. **Re-embed after adding documents** — `qmd embed` must be re-run when\n   new files are added to collections.\n3. **Use `qmd search` for speed** — when you need fast keyword lookup\n   (code identifiers, exact names), BM25 is instant and needs no models.\n4. **Use `qmd query` for quality** — when the question is conceptual or\n   the user needs the best possible results, use hybrid search.\n5. **Prefer MCP integration** — once configured, the agent gets native\n   tools without needing to load this skill each time.\n6. **Daemon mode for frequent users** — if the user searches their\n   knowledge base regularly, recommend the HTTP daemon setup.\n7. **First query in structured search gets 2x weight** — put the most\n   important\u002Fcertain query first when combining lex and vec.\n\n## Troubleshooting\n\n### \"Models downloading on first run\"\nNormal — qmd auto-downloads ~2GB of GGUF models on first use.\nThis is a one-time operation.\n\n### Cold start latency (~19s)\nThis happens when models aren't loaded in memory. Solutions:\n- Use HTTP daemon mode (`qmd mcp --http --daemon`) to keep warm\n- Use `qmd search` (BM25 only) when models aren't needed\n- MCP stdio mode loads models on first search, stays warm for session\n\n### macOS: \"unable to load extension\"\nInstall Homebrew SQLite: `brew install sqlite`\nThen ensure it's on PATH before system SQLite.\n\n### \"No collections found\"\nRun `qmd collection add \u003Cpath> --name \u003Cname>` to add directories,\nthen `qmd embed` to index them.\n\n### Embedding model override (CJK\u002Fmultilingual)\nSet `QMD_EMBED_MODEL` environment variable for non-English content:\n```bash\nexport QMD_EMBED_MODEL=\"your-multilingual-model\"\n```\n\n## Data Storage\n\n- **Index & vectors:** `~\u002F.cache\u002Fqmd\u002Findex.sqlite`\n- **Models:** Auto-downloaded to local cache on first run\n- **No cloud dependencies** — everything runs locally\n\n## References\n\n- [GitHub: tobi\u002Fqmd](https:\u002F\u002Fgithub.com\u002Ftobi\u002Fqmd)\n- [QMD Changelog](https:\u002F\u002Fgithub.com\u002Ftobi\u002Fqmd\u002Fblob\u002Fmain\u002FCHANGELOG.md)\n\n## ? Связи\n\n- [[000 - Map of Maps]] — REPO_DOCS\n- [[000 - Map of Maps]] — Map of Maps\n\n",{"name":5,"author":48,"license":15,"version":49,"metadata":50,"platforms":62,"description":7},"Hermes Agent + Teknium","1.0.0",{"hermes":51},{"tags":52,"related_skills":58},[53,54,55,56,34,57],"Search","Knowledge-Base","RAG","Notes","Local-AI",[59,60,61],"obsidian","native-mcp","arxiv",[41,63],"linux","main","bdd9f958d7bb1a0f19b8ad8da020b0bab0f53eb1","vc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002FREPO_DOCS\u002F02-hermes-agent\u002Foptional-skills\u002Fresearch\u002Fqmd",1,"https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis","2026-06-24 16:31:18",{"source":8,"skillName":5,"commands":72,"prompt":82,"zipAvailable":83},[73,76,79],{"tool":74,"command":75},"npx","npx skills add ibragimov-oasis\u002Fvibe-coder --skill qmd",{"tool":77,"command":78},"bunx","bunx skills add ibragimov-oasis\u002Fvibe-coder --skill qmd",{"tool":80,"command":81},"pnpm","pnpm dlx skills add ibragimov-oasis\u002Fvibe-coder --skill qmd","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002FREPO_DOCS\u002F02-hermes-agent\u002Foptional-skills\u002Fresearch\u002Fqmd\u002FSKILL.md",true,[],[86,121,146,166,192,222],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":100,"publishedAt":43},"01M6Q4Q22KKKVMJJYA411DQ4ER","ckm:ui-styling","Create beautiful, accessible user interfaces with shadcn\u002Fui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fui-styling\u002FSKILL.md",[92,95],{"categoryNo":93,"categoryName":94,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":96,"categoryName":97,"taxonomyType":98,"taxonomyTypeDesc":99},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120],"ui styling","ui","styling","ckm:ui styling","ckm","design","css","canvas","components","component","create","design systems","Tailwind","across","themes","utility","mode","implementing","artifact\u002Fui-component","source\u002Fui-design",{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":133,"publishedAt":43},"01M6Q4PQ2NX4NDVWTEHA3MQ2R0","ckm:design","Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social\u002Fads\u002Fweb\u002Fprint), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fdesign\u002FSKILL.md",[127,130,131,132],{"categoryNo":128,"categoryName":129,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000003","演示文稿",{"categoryNo":93,"categoryName":94,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":96,"categoryName":97,"taxonomyType":98,"taxonomyTypeDesc":99},[106,123,105,134,110,101,135,111,136,137,138,139,140,141,142,143,144,145,119,120],"google","presentations","generate","screenshot","actions","Media","logo","ads","youtube","tiktok","artifact","chart",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":154,"publishedAt":43},"01M6Q4PJE27GEA3M0CECEBCZKS","ckm:design-system","Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing\u002Ftypography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fdesign-system\u002FSKILL.md",[152,153],{"categoryNo":93,"categoryName":94,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":96,"categoryName":97,"taxonomyType":98,"taxonomyTypeDesc":99},[106,155,156,157,123,105,107,110,158,135,144,159,160,161,162,163,164,165,119,120],"design system","system","ckm:design system","architecture","token","creation","systematic","css variables","Variables","spacing","layer",{"skillNo":167,"name":168,"nameZh":6,"description":169,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":170,"categories":171,"keywords":177,"publishedAt":43},"01M6Q4P90JXFYMH2S634QM6SQJ","ckm:banner-design","Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter\u002FX, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fbanner-design\u002FSKILL.md",[172,175,176],{"categoryNo":173,"categoryName":174,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":93,"categoryName":94,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":96,"categoryName":97,"taxonomyType":98,"taxonomyTypeDesc":99},[106,178,179,180,105,181,138,139,182,183,184,185,186,187,188,189,119,120,190,191],"banner design","ckm:banner design","banner","frontend","3D","generated","Art","social","dimensions","neon","direction","display","frontend-design","hero",{"skillNo":193,"name":194,"nameZh":6,"description":195,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":196,"categories":197,"keywords":204,"publishedAt":43},"01M6Q2RZXBJ9TBE413GXCYQNDB","seo","Comprehensive SEO analysis for any website or business type. Performs full site audits, single-page deep analysis, technical SEO checks (crawlability, indexability, Core Web Vitals with INP), schema markup detection\u002Fvalidation\u002Fgeneration, content quality assessment (E-E-A-T framework per Dec 2025 update extending to all competitive queries), image optimization, sitemap analysis, and Generative Engine Optimization (GEO) for AI Overviews, ChatGPT, and Perplexity citations. Analyzes AI crawler accessibility (GPTBot, ClaudeBot, PerplexityBot), llms.txt compliance, brand mention signals, and passage-level citability. Industry detection for SaaS, e-commerce, local business, publishers, agencies. Triggers on: \"SEO\", \"audit\", \"schema\", \"Core Web Vitals\", \"sitemap\", \"E-E-A-T\", \"AI Overviews\", \"GEO\", \"technical SEO\", \"content quality\", \"page speed\", \"structured data\".","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fskills\u002Fskills-seo\u002Fseo\u002Fclaude-seo\u002Fskills\u002Fseo\u002FSKILL.md",[198,201],{"categoryNo":199,"categoryName":200,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000019","营销推广",{"categoryNo":202,"categoryName":203,"taxonomyType":98,"taxonomyTypeDesc":99},"01JBSEEDCAT000000000000035","市场营销",[194,205,206,207,208,209,210,144,30,211,212,213,214,215,216,217,218,219,220,221],"image","llms","assessment","deep analysis","Citations","analysis","deep","crawlability","seo analysis","2025","commerce","URL","domain\u002Fseo","source\u002Fskills-seo","vitals","generative","publishers",{"skillNo":223,"name":224,"nameZh":6,"description":225,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":226,"categories":227,"keywords":230,"publishedAt":43},"01M6Q2RVE7VGFCFQKBK468NHVY","seo-technical","Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol. Use when user says \"technical SEO\", \"crawl issues\", \"robots.txt\", \"Core Web Vitals\", \"site speed\", or \"security headers\".","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fskills\u002Fskills-seo\u002Fseo\u002Fclaude-seo\u002Fskills\u002Fseo-technical\u002FSKILL.md",[228,229],{"categoryNo":199,"categoryName":200,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":202,"categoryName":203,"taxonomyType":98,"taxonomyTypeDesc":99},[194,231,232,233,234,235,236,237,238,144,114,212,239,240,216,241,242,217,218,219],"technical","seo technical","issues","audit","data","mobile","crawl","structure","rendering","technical seo audit","headers","categories"]