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 agentmods add skills/spillwavesolutions/agent-brain/using-agent-brainnpx skills add SpillwaveSolutions/agent-brain --skill using-agent-braingit clone --depth 1 https://github.com/SpillwaveSolutions/agent-brainWrote 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/spillwavesolutions/agent-brain/using-agent-brain)<a href="https://agentmods.dev/skills/spillwavesolutions/agent-brain/using-agent-brain"><img src="https://agentmods.dev/badge/skills/spillwavesolutions/agent-brain/using-agent-brain.svg" alt="Measured on agentmods" 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.00249 | $0.03337 |
| Opus 5 | $0.00125 | $0.01669 |
| Sonnet 5 | $0.00050 | $0.00667 |
| Haiku 4.5 | $0.00025 | $0.00334 |
Grade A, and why
using-agent-brain 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 yesterday.
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 — 424 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Agent Brain Expert Skill
Expert-level skill for Agent Brain document search with five modes: BM25 (keyword), Vector (semantic), Hybrid (fusion), Graph (knowledge graph), and Multi (comprehensive fusion).
Contents
- Search Modes
- Mode Selection Guide
- GraphRAG (Knowledge Graph)
- Indexing & Folder Management
- Content Injection
- Job Queue Management
- Server Management
- Cache Management
- When Not to Use
- Best Practices
- Reference Documentation
Search Modes
| Mode | Speed | Best For | Example Query |
|---|---|---|---|
bm25 |
Fast (10-50ms) | Technical terms, function names, error codes | "AuthenticationError" |
vector |
Slower (800-1500ms) | Concepts, explanations, natural language | "how authentication works" |
hybrid |
Slower (1000-1800ms) | Comprehensive results combining both | "OAuth implementation guide" |
graph |
Medium (500-1200ms) | Relationships, dependencies, call chains | "what calls AuthService" |
multi |
Slowest (1500-2500ms) | Most comprehensive with entity context | "complete auth flow with dependencies" |
Mode Parameters
| Parameter | Default | Description |
|---|---|---|
--mode |
hybrid | Search mode: bm25, vector, hybrid, graph, multi |
--threshold |
0.3 | Minimum similarity (0.0-1.0) |
--top-k |
5 | Number of results |
--alpha |
0.5 | Hybrid balance (0=BM25, 1=Vector) |
Mode Selection Guide
Use BM25 When
Searching for exact technical terms:
agent-brain query "recursiveCharacterTextSplitter" --mode bm25
agent-brain query "ValueError: invalid token" --mode bm25
agent-brain query "def process_payment" --mode bm25
Counter-example - Wrong mode choice:
# BM25 is wrong for conceptual queries
agent-brain query "how does error handling work" --mode bm25 # Wrong
agent-brain query "how does error handling work" --mode vector # Correct
What ships with it
13 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- references/api_reference.md 12 KB
- references/bm25-search-guide.md 5.9 KB
- references/graph-search-guide.md 11 KB
- references/hybrid-search-guide.md 12 KB
- references/installation-guide.md 7.5 KB
- references/integration-guide.md 4.1 KB
- references/interactive-setup.md 4.3 KB
- references/provider-configuration.md 11 KB
- references/server-discovery.md 4.5 KB
- references/troubleshooting-guide.md 12 KB
- references/vector-search-guide.md 7.7 KB
- references/version-management.md 7.6 KB
- scripts/query_domain.py 5.0 KB runs code
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.
- yesterday First seen · 424 lines · 249 tokens per session scan A 95444a017f45
using-agent-brain is a skill published in the GitHub repository SpillwaveSolutions/agent-brain (118 stars, last pushed 2d ago), licensed MIT. It adds 249 tokens to every session and 3,337 once invoked, about $0.0012 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-05.
Other skills, from other repositories
install-openviking-memory
Install and configure the OpenViking long-term memory plugin for OpenClaw via natural conversation. Once installed, the plugin automatically captures facts from chats and recalls relevant context before each reply (auto-capture + auto-recall, cross-session). Covers prerequisites, install through OpenClaw's plugin…
rag-knowledge
Work with the RAG knowledge base — ingest documents, run semantic search, manage collections, or add a sync source/connector (Google Drive, S3). Use when populating or debugging the knowledge base, tuning retrieval, or adding a new document source. This project uses {{ cookiecutter.vectorstore }} + {{…
knowledge-distillation
Compile one or more OpenViking knowledge bases or document collections into topic-organized, evidence-grounded high-level knowledge, including cross-source findings, trends, changes, drivers, comparisons, implications, and uncertainties. Use with ov compile when the user asks to distill or synthesize a knowledge base…
knowledge-graph
Compile documents, notes, web content, transcripts, research materials, or code repositories into an evidence-grounded, visualization-ready knowledge graph with semantically typed entity nodes, statement-level provenance, and typed relationship edges. Use with ov compile to create or incrementally refresh entities/.md…
backlot
Emulate enterprise SaaS knowledge APIs — Slack, Gmail, Google Drive (with Docs, Sheets, Slides), GitHub, Jira, Confluence, Notion, Amazon S3, HubSpot, Linear, Fireflies — over a corpus you supply, then point a real client (vendor SDK, MCP server, LlamaIndex reader, fsspec, mirage) at it. Applies in ANY directory, an…
mfs-ingest
Register, update, or re-sync data sources for MFS so they become searchable — postgres / mysql / mongo / snowflake / bigquery, github / jira / linear / notion / hubspot / zendesk, slack / discord / gmail / feishu, s3 / gdrive / web / file. Use whenever the user wants to ADD a new data source to MFS, change an existing…