[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B2QJSFR0ZCK5QB402AA5DQ":3,"skill-same:01M7B2QJSFR0ZCK5QB402AA5DQ":45},{"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":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7B2QJSFR0ZCK5QB402AA5DQ","wiki-retrieve",null,"Build and query a vault-local contextual BM25 retrieval index with optional multilingual Nomic cosine reranking; use for retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, chunk search, vault search, semantic search, find relevant passages, or retrieval diagnostics. Derived caches stay under .vault-meta, remote egress requires explicit consent, and unavailable reranking falls back deterministically.","Perryong\u002Fknowledge-brain","Perryong","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F67753175?v=4","01M7B2P4V7VJ31NK9B6N15FV95","Perry Ong WQ","01M7B2P4VVN72C07228FVB427F",0,"MIT","https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Fskills\u002Fwiki-retrieve\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: wiki-retrieve\ndescription: \"Build and query a vault-local contextual BM25 retrieval index with optional multilingual Nomic cosine reranking; use for retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, chunk search, vault search, semantic search, find relevant passages, or retrieval diagnostics. Derived caches stay under .vault-meta, remote egress requires explicit consent, and unavailable reranking falls back deterministically.\"\n---\n\n# Retrieve relevant passages\n\nThis extension derives search data from `wiki\u002F` into `.vault-meta\u002F`. It never\nchanges canonical notes. Always pass the selected vault explicitly.\n\nResolve the installed product root from this skill's own location, not from the\nvault or current working directory:\n\n```bash\nPRODUCT_ROOT=\u002Fabsolute\u002Fpath\u002Fto\u002Finstalled\u002Fclaude-obsidian\nPREFIX=\"$PRODUCT_ROOT\u002Fscripts\u002Fcontextual-prefix.py\"\nBM25=\"$PRODUCT_ROOT\u002Fscripts\u002Fbm25-index.py\"\nRETRIEVE=\"$PRODUCT_ROOT\u002Fscripts\u002Fretrieve.py\"\nRERANK=\"$PRODUCT_ROOT\u002Fscripts\u002Frerank.py\"\ntest -f \"$PREFIX\" && test -f \"$BM25\" && test -f \"$RETRIEVE\" && test -f \"$RERANK\"\n```\n\n## Pipeline\n\n1. `contextual-prefix.py` splits pages on paragraph boundaries and stores the\n   raw chunk plus a short page-level prefix.\n2. `bm25-index.py` builds a local, standard-library BM25 index over the\n   contextualized text.\n3. `retrieve.py` selects BM25 candidates, optionally reranks them, rejects\n   invalid records, deduplicates by page, and returns paths and snippets.\n4. The caller reads the returned pages and performs synthesis; retrieval output\n   is not itself evidence.\n\n## Provision locally\n\nPreview first, then build synthetic prefixes without network egress:\n\n```bash\npython3 \"$PREFIX\" --vault \"$VAULT\" --all --no-llm --peek\npython3 \"$PREFIX\" --vault \"$VAULT\" --all --no-llm\npython3 \"$BM25\" --vault \"$VAULT\" build\npython3 \"$RETRIEVE\" --vault \"$VAULT\" \"wiki\" --top 1 --no-rerank --explain\n```\n\nChunk and index files are disposable runtime state. Incremental prefixing skips\nrecords whose chunk and page hashes still match. A complete scan removes\nsurplus records for deleted pages, and the prefixer invalidates the BM25 index\nbefore changing its chunk set so a mixed stale index is not served.\nPrefix and BM25 build operations share the vault-wide mutation lock with every\nother writer; a busy vault fails closed instead of publishing a partial index.\n\n## Contextual-prefix privacy\n\nSynthetic prefixes use only local frontmatter and page text. The Anthropic API\nand `claude` subprocess tiers can send page bodies off-machine and therefore\nrequire the user's explicit consent plus `--allow-egress`. Never infer consent\nfrom an API key or installed binary. Preview the scope first and state which\nprovider will receive what data.\n\nRemote Ollama endpoints also require explicit approval and\n`--allow-remote-ollama`; the default reranker accepts localhost only.\n\n## Query\n\nFor a strictly read-only lookup, use the prebuilt BM25 index:\n\n```bash\npython3 \"$RETRIEVE\" --vault \"$VAULT\" \"$QUERY\" --top 5 --no-rerank --explain\n```\n\nFor an explicitly requested rerank, omit `--no-rerank`. The default is Ollama's\nmultilingual `nomic-embed-text-v2-moe` model (approximately 958 MB); the product\nnever pulls it automatically. To use an already-installed, smaller,\nEnglish-oriented v1.5 model, pass `--model nomic-embed-text` explicitly.\nNomic models use `search_query:` for the query and `search_document:` for\ncandidate text. Nomic v2 has a 512-token input context and Ollama truncates\nlonger embedding inputs by default; BM25 still scores the complete chunk.\nEmbeddings are cached by exact model, input scheme, and hash of the exact\nprefixed input. A missing local Ollama service, missing selected\nmodel, unusable vector, or any candidate embedding failure falls back for the\ncomplete result set to the original BM25 order; it never mixes cosine and BM25\nscore scales.\n\nQuery input is bounded at 8,000 normalized characters and result counts must be\nbetween 1 and 1,000. Oversized queries and invalid limits fail with an\nactionable usage error instead of looking like an empty successful search.\nAn untagged model request matches only the installed untagged name or its\n`:latest` alias; select any other tag explicitly.\n\nUse direct diagnostics when needed:\n\n```bash\npython3 \"$BM25\" --vault \"$VAULT\" stats\npython3 \"$BM25\" --vault \"$VAULT\" query \"$QUERY\" --top 10\npython3 \"$RERANK\" --vault \"$VAULT\" \"$QUERY\" --peek\npython3 \"$RERANK\" --vault \"$VAULT\" \"$QUERY\" --model nomic-embed-text --peek\n```\n\n## Integrity rules\n\n- Accept only relative chunk and page paths whose resolved targets remain under\n  `$VAULT\u002F.vault-meta\u002Fchunks\u002F` and `$VAULT\u002Fwiki\u002F` respectively.\n- Reject hashless legacy chunk records and require chunk-body, page, and index\n  hashes to match before a cached record can be built or served.\n- Reject absolute paths, symlink escapes, missing pages, mismatched chunk IDs,\n  changed page hashes, and stale index\u002Fchunk hash pairs.\n- Rerank the full candidate set, then deduplicate by page, then apply `--top`.\n- An empty index is an honest no-result state. A missing or corrupt index makes\n  `retrieve.py` exit 10 with a stable rebuild command; callers fall back to the\n  standard vault query\u002Ftext-search path and do not fabricate matches.\n- Do not cite benchmark percentages unless a reproducible vault-specific\n  benchmark produced them.\n\n## Checkpoint\n\nObserve cache readiness and privacy boundaries, think about whether lexical or\nsemantic ranking is needed, verify returned paths and source freshness, and\ngrow by measuring retrieval misses against a maintained local query set.\n","# Retrieve relevant passages\n\nThis extension derives search data from `wiki\u002F` into `.vault-meta\u002F`. It never\nchanges canonical notes. Always pass the selected vault explicitly.\n\nResolve the installed product root from this skill's own location, not from the\nvault or current working directory:\n\n```bash\nPRODUCT_ROOT=\u002Fabsolute\u002Fpath\u002Fto\u002Finstalled\u002Fclaude-obsidian\nPREFIX=\"$PRODUCT_ROOT\u002Fscripts\u002Fcontextual-prefix.py\"\nBM25=\"$PRODUCT_ROOT\u002Fscripts\u002Fbm25-index.py\"\nRETRIEVE=\"$PRODUCT_ROOT\u002Fscripts\u002Fretrieve.py\"\nRERANK=\"$PRODUCT_ROOT\u002Fscripts\u002Frerank.py\"\ntest -f \"$PREFIX\" && test -f \"$BM25\" && test -f \"$RETRIEVE\" && test -f \"$RERANK\"\n```\n\n## Pipeline\n\n1. `contextual-prefix.py` splits pages on paragraph boundaries and stores the\n   raw chunk plus a short page-level prefix.\n2. `bm25-index.py` builds a local, standard-library BM25 index over the\n   contextualized text.\n3. `retrieve.py` selects BM25 candidates, optionally reranks them, rejects\n   invalid records, deduplicates by page, and returns paths and snippets.\n4. The caller reads the returned pages and performs synthesis; retrieval output\n   is not itself evidence.\n\n## Provision locally\n\nPreview first, then build synthetic prefixes without network egress:\n\n```bash\npython3 \"$PREFIX\" --vault \"$VAULT\" --all --no-llm --peek\npython3 \"$PREFIX\" --vault \"$VAULT\" --all --no-llm\npython3 \"$BM25\" --vault \"$VAULT\" build\npython3 \"$RETRIEVE\" --vault \"$VAULT\" \"wiki\" --top 1 --no-rerank --explain\n```\n\nChunk and index files are disposable runtime state. Incremental prefixing skips\nrecords whose chunk and page hashes still match. A complete scan removes\nsurplus records for deleted pages, and the prefixer invalidates the BM25 index\nbefore changing its chunk set so a mixed stale index is not served.\nPrefix and BM25 build operations share the vault-wide mutation lock with every\nother writer; a busy vault fails closed instead of publishing a partial index.\n\n## Contextual-prefix privacy\n\nSynthetic prefixes use only local frontmatter and page text. The Anthropic API\nand `claude` subprocess tiers can send page bodies off-machine and therefore\nrequire the user's explicit consent plus `--allow-egress`. Never infer consent\nfrom an API key or installed binary. Preview the scope first and state which\nprovider will receive what data.\n\nRemote Ollama endpoints also require explicit approval and\n`--allow-remote-ollama`; the default reranker accepts localhost only.\n\n## Query\n\nFor a strictly read-only lookup, use the prebuilt BM25 index:\n\n```bash\npython3 \"$RETRIEVE\" --vault \"$VAULT\" \"$QUERY\" --top 5 --no-rerank --explain\n```\n\nFor an explicitly requested rerank, omit `--no-rerank`. The default is Ollama's\nmultilingual `nomic-embed-text-v2-moe` model (approximately 958 MB); the product\nnever pulls it automatically. To use an already-installed, smaller,\nEnglish-oriented v1.5 model, pass `--model nomic-embed-text` explicitly.\nNomic models use `search_query:` for the query and `search_document:` for\ncandidate text. Nomic v2 has a 512-token input context and Ollama truncates\nlonger embedding inputs by default; BM25 still scores the complete chunk.\nEmbeddings are cached by exact model, input scheme, and hash of the exact\nprefixed input. A missing local Ollama service, missing selected\nmodel, unusable vector, or any candidate embedding failure falls back for the\ncomplete result set to the original BM25 order; it never mixes cosine and BM25\nscore scales.\n\nQuery input is bounded at 8,000 normalized characters and result counts must be\nbetween 1 and 1,000. Oversized queries and invalid limits fail with an\nactionable usage error instead of looking like an empty successful search.\nAn untagged model request matches only the installed untagged name or its\n`:latest` alias; select any other tag explicitly.\n\nUse direct diagnostics when needed:\n\n```bash\npython3 \"$BM25\" --vault \"$VAULT\" stats\npython3 \"$BM25\" --vault \"$VAULT\" query \"$QUERY\" --top 10\npython3 \"$RERANK\" --vault \"$VAULT\" \"$QUERY\" --peek\npython3 \"$RERANK\" --vault \"$VAULT\" \"$QUERY\" --model nomic-embed-text --peek\n```\n\n## Integrity rules\n\n- Accept only relative chunk and page paths whose resolved targets remain under\n  `$VAULT\u002F.vault-meta\u002Fchunks\u002F` and `$VAULT\u002Fwiki\u002F` respectively.\n- Reject hashless legacy chunk records and require chunk-body, page, and index\n  hashes to match before a cached record can be built or served.\n- Reject absolute paths, symlink escapes, missing pages, mismatched chunk IDs,\n  changed page hashes, and stale index\u002Fchunk hash pairs.\n- Rerank the full candidate set, then deduplicate by page, then apply `--top`.\n- An empty index is an honest no-result state. A missing or corrupt index makes\n  `retrieve.py` exit 10 with a stable rebuild command; callers fall back to the\n  standard vault query\u002Ftext-search path and do not fabricate matches.\n- Do not cite benchmark percentages unless a reproducible vault-specific\n  benchmark produced them.\n\n## Checkpoint\n\nObserve cache readiness and privacy boundaries, think about whether lexical or\nsemantic ranking is needed, verify returned paths and source freshness, and\ngrow by measuring retrieval misses against a maintained local query set.\n",{"name":5,"description":7},"main","1b6b4755bf678871237e0047cbac7a467824d0d4","skills\u002Fwiki-retrieve",1,"https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain","https:\u002F\u002Fgithub.com\u002FPerryong","2026-11-14 10:36:45",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add Perryong\u002Fknowledge-brain --skill wiki-retrieve",{"tool":37,"command":38},"bunx","bunx skills add Perryong\u002Fknowledge-brain --skill wiki-retrieve",{"tool":40,"command":41},"pnpm","pnpm dlx skills add Perryong\u002Fknowledge-brain --skill wiki-retrieve","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Fskills\u002Fwiki-retrieve\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7B2QSV52XZ3153FYF6X6ZBB","example","Hermetic contract-validation fixture.","https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fcontracts\u002Fvalid\u002Fskills\u002Fexample\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7B2QP3HQQT2QDHEDM4QT2PD","wiki","Initialize, adopt, and route work for a separate Obsidian knowledge vault through the portable claude-obsidian core. Use for vault setup, scaffolding, workspace selection, cross-project configuration, or choosing the correct wiki sub-skill. Triggers: \u002Fwiki, set up wiki, scaffold vault, create knowledge base, adopt this vault, Obsidian vault, second brain setup, persistent wiki.","https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Fskills\u002Fwiki\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7B2QFQW4NSVSXWRR9WQ7NAH","wiki-query","Answer an explicitly vault-scoped question from an Obsidian wiki without changing it. Use when the user selects the vault as the evidence source: query the wiki, query quick, query deep, explain from the wiki, summarize the vault, find in wiki, search the wiki, or based on the wiki. Do not route ordinary general-knowledge questions here.","https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Fskills\u002Fwiki-query\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7B2QCP36HBTQXF0XY15MX95","wiki-mode","Read or configure the vault filing methodology and suggest destinations for planned knowledge creation under Generic, LYT, PARA, or Zettelkasten. Use for wiki mode, methodology mode, what is my vault mode, set vault mode, switch to PARA, use LYT, Zettelkasten setup, change mode, configure mode, or methodology routing. This skill does not save content or migrate notes.","https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Fskills\u002Fwiki-mode\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7B2Q9SMNY50QKDRD68QGSYQ","wiki-lint","Run a deterministic, read-only health check on an Obsidian wiki. Use for lint, vault health check, audit wiki health, find orphans, find dead links, frontmatter audit, provenance audit, or wiki audit. Reports graph, link, frontmatter, provenance-ledger, empty-section, and stale-index findings; it does not reason broadly or repair files.","https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Fskills\u002Fwiki-lint\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7B2Q6C5SQ85B428TPW4YBH0","wiki-ingest","Ingest supplied source material into an Obsidian vault with provenance and claim tracking: pasted text, files staged in the selected vault's inbox or .raw archive, or explicitly approved URLs. Use for a single source or bounded batch, not for saving an assistant answer. Triggers: ingest, ingest this file, ingest this URL, process this source, read and file this source, batch ingest, ingest these sources.","https:\u002F\u002Fgithub.com\u002FPerryong\u002Fknowledge-brain\u002Fblob\u002Fmain\u002Fskills\u002Fwiki-ingest\u002FSKILL.md",[],[]]