Skip to content
SkillModel-led1,584 tokens in use

Wiki Retrieve

Builds a local BM25 search index over an Obsidian wiki and returns the most relevant passages, with optional embedding rerank.

16,653 stars on the repository MIT LicenseAgriciDaniel/claude-obsidian · skills/wiki-retrieve
claude plugin marketplace add AgriciDaniel/claude-obsidian claude plugin install claude-obsidian@agricidaniel-claude-obsidian
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Wiki Retrieve costs

82tokens idle
1,584tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure19/25
  • Examples9/15
  • Output15/15
  • Size10/15
  • Resources10/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 15

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity84
  • Maintenance100
  • Community56
  • Maturity28
  • Momentum40

Wiki Retrieve is the search skill of the claude-obsidian plugin. It splits wiki pages into chunks, adds a short page-level prefix to each, builds a BM25 index and returns paths and snippets for a query.

Everything it derives is stored under the vault’s .vault-meta folder and your notes are never changed. Reranking with a local embedding model is optional, and sending page text to a remote service needs your explicit consent.

What You Get

  • A local contextual BM25 index of the wiki, kept as disposable cache files under .vault-meta
  • Query results with page paths, snippets and an optional explanation of the ranking
  • Optional rerank with a multilingual or a smaller English Nomic embedding model
  • Diagnostic commands for index stats, direct queries and rerank previews
  • A stable error and rebuild command when the index is missing or corrupt

Common Use Cases

  • Finding the passages in a large vault that match a question
  • Building the search index that the wiki-query skill uses
  • Comparing lexical search with reranked results on your own notes
  • Measuring recall and ranking quality on a set of labeled questions

What Makes It Unique

The index is local, deterministic and built with the Python standard library, so a basic setup needs no model download. Reranking falls back to the original BM25 order as a whole when any embedding step fails, so score scales are never mixed. The skill also checks that every path stays inside the vault, rejects symlink escapes and stale hashes, and requires consent before page text leaves the machine.

Under The Hood

The skill loads its SKILL.md and runs shell commands that call four Python scripts from the installed plugin: one to split pages and write prefixes, one to build the BM25 index, one to query it and one to rerank. They read the wiki folder and write chunk and index cache files under the vault’s .vault-meta folder. Reranking calls a local Ollama service on localhost over HTTP. An option exists to send page bodies to the Anthropic API, and another to use a remote Ollama endpoint; both need your consent and an explicit flag. It does not fetch web pages.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers