How do I install the Bm25 Search skill?

Run npx skillmds@latest add spillwavesolutions/bm25-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bm25 Search safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bm25 Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bm25 Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bm25 Search?

spillwavesolutions (@spillwavesolutions) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bm25 Search by spillwavesolutions — Agent Skill

Name: Bm25 Search
Author: spillwavesolutions

Bm25 Search

BM25 keyword search for agent-memory. Use when asked to "find exact terms", "keyword search", "search for specific function names", "locate exact phrase", or when semantic search returns too many results. Provides fast BM25 full-text search via Tantivy index.

spillwavesolutions 42f49b5 2 files · 4.1 KB Updated Sep 17, 2026

File contents

BM25 Keyword Search Skill

Fast full-text keyword search using BM25 scoring in the agent-memory system.

When to Use

Use Case	Best Search Type
Exact keyword match	BM25 (`teleport search`)
Function/variable names	BM25 (exact terms)
Error messages	BM25 (specific phrases)
Technical identifiers	BM25 (case-sensitive)
Conceptual similarity	Vector search instead

When Not to Use

Conceptual/semantic queries (use vector search)
Synonym-heavy queries (use hybrid search)
Current session context (already in memory)
Time-based navigation (use TOC directly)

Quick Start

Command	Purpose	Example
`teleport search`	BM25 keyword search	`teleport search "ConnectionTimeout"`
`teleport stats`	BM25 index status	`teleport stats`
`teleport rebuild`	Rebuild index	`teleport rebuild --force`

Prerequisites

memory-daemon status  # Check daemon
memory-daemon start   # Start if needed

BM25 Search

Basic Usage

# Simple keyword search
memory-daemon teleport search "JWT token"

# Search with options
memory-daemon teleport search "authentication" \
  --top-k 10 \
  --target toc

# Phrase search (exact match)
memory-daemon teleport search "\"connection refused\""

Query Syntax

Pattern	Example	Matches
Single term	`JWT`	All docs containing "JWT"
Multiple terms	`JWT token`	Docs with "JWT" AND "token"
Phrase	`"JWT token"`	Exact phrase "JWT token"
Prefix	`auth*`	Terms starting with "auth"

Error Handling

Error	Resolution
Connection refused	`memory-daemon start`
BM25 index unavailable	`teleport rebuild` or wait for build
No results	Check spelling, try broader terms
Slow response	Rebuild index or check disk

See Command Reference for full CLI options.

---name: bm25-searchdescription: BM25 keyword search for agent-memory. Use when asked to "find exact terms", "keyword search", "search for specific function names", "locate exact phrase", or when semantic search returns too many results. Provides fast BM25 full-text search via Tantivy index.---# BM25 Keyword Search SkillFast full-text keyword search using BM25 scoring in the agent-memory system.## When to Use| Use Case | Best Search Type ||----------|------------------|| Exact keyword match | BM25 (`teleport search`) || Function/variable names | BM25 (exact terms) || Error messages | BM25 (specific phrases) || Technical identifiers | BM25 (case-sensitive) || Conceptual similarity | Vector search instead |## When Not to Use- Conceptual/semantic queries (use vector search)- Synonym-heavy queries (use hybrid search)- Current session context (already in memory)- Time-based navigation (use TOC directly)## Quick Start| Command | Purpose | Example ||---------|---------|---------|| `teleport search` | BM25 keyword search | `teleport search "ConnectionTimeout"` || `teleport stats` | BM25 index status | `teleport stats` || `teleport rebuild` | Rebuild index | `teleport rebuild --force` |## Prerequisites```bashmemory-daemon status # Check daemonmemory-daemon start # Start if needed```## BM25 Search### Basic Usage```bash# Simple keyword searchmemory-daemon teleport search "JWT token"# Search with optionsmemory-daemon teleport search "authentication" \ --top-k 10 \ --target toc# Phrase search (exact match)memory-daemon teleport search "\"connection refused\""```### Query Syntax| Pattern | Example | Matches ||---------|---------|---------|| Single term | `JWT` | All docs containing "JWT" || Multiple terms | `JWT token` | Docs with "JWT" AND "token" || Phrase | `"JWT token"` | Exact phrase "JWT token" || Prefix | `auth*` | Terms starting with "auth" |## Error Handling| Error | Resolution ||-------|------------|| Connection refused | `memory-daemon start` || BM25 index unavailable | `teleport rebuild` or wait for build || No results | Check spelling, try broader terms || Slow response | Rebuild index or check disk |See [Command Reference](references/command-reference.md) for full CLI options.

Frequently asked questions