Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add tboome33/obsidian-mcp-router --skill read-search-smartgit clone --depth 1 https://github.com/tboome33/obsidian-mcp-routerWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/tboome33/obsidian-mcp-router/read-search-smart)<a href="https://agentmods.dev/skills/tboome33/obsidian-mcp-router/read-search-smart"><img src="https://agentmods.dev/badge/skills/tboome33/obsidian-mcp-router/read-search-smart/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/tboome33/obsidian-mcp-router/read-search-smart"><img src="https://agentmods.dev/badge/skills/tboome33/obsidian-mcp-router/read-search-smart.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00147 | $0.01165 |
| Opus 5 | $0.00073 | $0.00583 |
| Sonnet 5 | $0.00029 | $0.00233 |
| Haiku 4.5 | $0.00015 | $0.00117 |
Grade A, and why
read-search-smart scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.
read-search-smart
Call the obsidian-router search_smart MCP tool with arguments parsed from $ARGUMENTS.
Arguments
Required:
query— natural-language query (not a literal substring).
Optional:
vault— vault name. Omit for default. Pass*to fan-out across ALL vaults.folders— array of folder prefixes to restrict results (e.g.["Sessions", "Trades"]).excludeFolders— array of folder prefixes to exclude (e.g.[".trash", "Templates"]).limit— max results (default 10).tier— which engine answers:auto(default),semantic, orlocal. See below.
Argument parsing from $ARGUMENTS
- bare text in $ARGUMENTS →
query, default vault, default limit vault=X query="..."→ split--allor "across all vaults" → setvault: "*"--limit 20orlimit=20→ setlimit--in Sessions,Tradesorfolders=Sessions,Trades→ setfolders--local/ "recherche déterministe" / "sans plugin" → settier: "local"--semantic-only→ settier: "semantic"
The two tiers (v0.63.0, borrowing C4)
| tier | engine | needs |
|---|---|---|
semantic |
Smart Connections embeddings (cosine) | bridge + smart-connections plugins, indexed |
local |
local BM25 index (deterministic, pure JS) | build_search_index has been run once |
auto (the default) tries semantic and, only when that tier cannot serve this vault (plugin absent / route missing), falls back entirely to the local BM25 index. The two are never blended — their score scales are incomparable — and the response says which one answered.
Never present a fallback result as a semantic one. If the response carries tier: "local-bm25" with a fallback object, say so in one short line, e.g. "Smart Connections isn't available on this vault — these come from the local BM25 index."
Pre-requisites
None for tier: "local" beyond a built index. For the semantic tier the vault needs BOTH the obsidian-mcp-router-bridge and smart-connections plugins enabled and indexed — but you no longer need to handle that as an error: auto degrades on its own and labels the result.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 8d ago First seen · 86 lines · 147 tokens per session scan A 3391c004a87d
read-search-smart is a skill published in the GitHub repository tboome33/obsidian-mcp-router (1 stars, last pushed yesterday), licensed Apache-2.0. It adds 147 tokens to every session and 1,165 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
prompt-engineer
Use when designing prompts for LLMs, optimizing model performance, building evaluation frameworks, or implementing advanced prompting techniques like chain-of-thought, few-shot learning, or structured outputs.
midjourney-replicate-flux
Generate highly detailed, Midjourney-style image prompts optimized for the FLUX 1.1 Pro model on Replicate. Transform basic user descriptions into rich, cinematic prompts with professional photography qualities, dramatic lighting, and editorial-quality aesthetics. Use when users request image generation, need prompt…
guidance
Constrain LLM output with grammars; guarantee valid JSON.
outlines
Outlines: structured JSON/regex/Pydantic LLM generation.
omni-compression
Configure RTK (command output), Caveman (prose), and stacked compression modes. Manage language packs, custom rules, and test prompt compression reducing tokens by 60–90%.
cli-compression
Configure and test prompt compression from the CLI. Manage RTK filters, Caveman rules, stacked compression modes, and preview compression output with real prompts.