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-codebasesinstead. - For symbol lookup (
find:,source:,refs:) over a parsed codebase, usetree-sittingdirectly. - 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
To install:
- Click the download link above (ignore the "Source code" archives below - they're auto-generated by GitHub)
- Go to Claude.ai Customize › Skills
- Upload the downloaded ZIP file
- 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