github oaustegard/claude-skills bm25-v0.2.2
bm25 v0.2.2

one hour ago

bm25

Stateless BM25 content search over any text corpus. Wraps xhluca/bm25s in a small CLI.

See SKILL.md for the full reference.

Quick start

uv pip install --system --break-system-packages bm25s

BM25=/mnt/skills/user/bm25/scripts/bm25.py

python3 $BM25 ./repo 'csrf middleware'
python3 $BM25 'github.com/django/django' 'atomic transaction'
python3 $BM25 project 'RAG scaling laws'

Caching

The skill maintains a session-local cache at /home/claude/.bm25-cache/<key>/. The key hashes the inputs that determine the index (resolved corpus path, include/exclude globs, max file size), so any change naturally invalidates. First invocation against a corpus builds and saves; subsequent invocations load in ~50ms instead of rebuilding in seconds.

/home/claude/ is ephemeral, so the cache and the rest of the session state expire together — no cross-session invalidation problem. Use --no-cache to bypass if you've mutated the corpus mid-session.

Pairing with other skills

  • For code-specific search with regex routing and AST-expanded results, use searching-codebases instead.
  • For symbol lookup (find:, source:, refs:) over a parsed codebase, use tree-sitting directly.
  • bm25 fills the gap between those two and works on non-code corpora (project knowledge, transcripts, uploaded docs).

Skill folder: bm25


Release of bm25 version 0.2.2

📥 Download & Install

⬇️ Download bm25.zip

To install:

  1. Click the download link above (ignore the "Source code" archives below - they're auto-generated by GitHub)
  2. Go to Claude.ai Customize › Skills
  3. Upload the downloaded ZIP file
  4. Requires paid Claude Pro or Team account

See official documentation for more details.

Recent Changes

23e33f6 fix(bm25): invalidate cache on corpus edits; survive empty vocabulary (0.2.2)
ed5aef0 docs: Update CHANGELOG.md for released skills

Don't miss a new claude-skills release

NewReleases is sending notifications on new releases.