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 skills add nmdra/notebrain-cli --skill notebraingit clone --depth 1 https://github.com/nmdra/notebrain-cliWrote 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/nmdra/notebrain-cli/notebrain)<a href="https://agentmods.dev/skills/nmdra/notebrain-cli/notebrain"><img src="https://agentmods.dev/badge/skills/nmdra/notebrain-cli/notebrain/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/nmdra/notebrain-cli/notebrain"><img src="https://agentmods.dev/badge/skills/nmdra/notebrain-cli/notebrain.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.00129 | $0.02270 |
| Opus 5.5 | $0.00052 | $0.00908 |
| Sonnet 5.5 | $0.00026 | $0.00454 |
| Haiku 4.5 | $0.00013 | $0.00227 |
Grade A, and why
notebrain-assistant 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 22d ago.
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 — 115 lines — stays where its author put it; the contents beside it link to each section on GitHub.
NoteBrain Assistant Skill
NoteBrain indexes an Obsidian vault into local ChromaDB and answers read-only questions about it: semantic search, tag queries, graph structure, and note retrieval. It never mutates the vault. For writes, use standard file tools or obsidian-cli and keep NoteBrain for the discovery step.
References, read on demand:
- references/example.md: 18 worked scenarios, exact commands, verified pitfalls.
- references/flags.md: every flag, default, and config override.
- references/schema.md: JSON/TSV output shape,
--jsonpathuse.
Preflight (once per conversation)
notebrain stats --format=json
| Result | Do |
|---|---|
chunks: 0 |
The vault is unindexed. Tell the user to run notebrain ingest first. Do not try to read the vault another way. |
| Binary missing / errors | Say NoteBrain isn't available and offer to check setup. Do not grep/find the vault instead. |
chunks > 0 |
Proceed. |
The config trap: ~/.notebrain/config/config.toml (or --config) overrides built-in flag defaults. include-text, context-window, min-score, limit, and top-k all have config keys. If config enables text/context, every result carries text+context even without the flags. For lean output pass --include-text=false --context-window=0. If a query looks over-filtered, a configured min-score floor (e.g. 0.4) means low-score rows never appear. That's expected, not a bug. Details: flags.md.
Output format discipline
The CLI's default output format is text, but text is for humans. The agent always works from machine formats:
- Every invocation passes
--format jsonor--format tsvexplicitly. Never rely on the defaulttext. jsonis the default choice. The structured envelope carries nested fields (text,context,heading_path,tags,matched_queries). Shape: schema.md.tsvfor wide, shallow scans where columns suffice:tags --list,backlinks,connections,refsaudits, and--group-by-notenote lists.--jsonpathfor single-field extraction (slugs, scores, tags). It is the leanest output; combine with--limit/--show-file-path=false.--format textonly when the output is for the human: showing a note body (get "<slug>") or when the user asks to see the raw CLI output. Never parse text output, and never paste decorated text (headers,#-chips, "Did you mean" hints) into an answer. Everything the agent reads or summarizes comes fromjson/tsv.
What ships with it
3 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.
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.
- 22d ago Changed · +1 lines · -1 tokens per session 480323cfd122
- 1mo ago First seen · 114 lines · 130 tokens per session scan A 3b6a654a5a29
notebrain-assistant is a skill published in the GitHub repository nmdra/notebrain-cli (28 stars, last pushed yesterday), licensed MIT. It adds 129 tokens to every session and 2,270 once invoked, about $0.0005 per session on Opus 5.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-08-30.
Other skills, from other repositories
enzyme
Use Enzyme in an already activated Obsidian, Markdown, or Hermes workspace for working-memory retrieval, source-grounded exploration, semantic search by concept rather than keyword, runtime note-writing, and refresh. If the workspace is not initialized, follow the first-time setup section before normal retrieval.
enzyme-bootstrap
Connect Enzyme to the current Markdown vault. Use when the user asks to install, set up, or connect Enzyme and the vault does not yet have durable Enzyme agent instructions. Installs the full runtime and workspace skills into the vault, then hands setup to them. Do not use for ordinary retrieval in a vault that is…
brain-query
Semantic two-tier retrieval over the personal brain at /brain/. Queries brainwiki (synthesized pages) first, falls back to brainraw (raw source chunks) if confidence is low, and always reports which layer answered with a confidence score. Use when the user says "/brain-query", "search the brain", "semantic search", or…
wiki-query
Answer a question strictly from the user's brain at /brain/wiki/. Never answer from training memory on topics the wiki covers. Always cite the page used. Use when the user says "/wiki-query", "ask the brain", or asks a factual question about their work, clients, or projects.
mempalace
MemPalace — Local AI memory with 96.6% recall. Semantic search, temporal knowledge graph, palace architecture (wings/rooms/drawers). Free, no cloud, no API keys.
mempalace-task
Create, hand off, claim, execute, and close agent tasks through the MemPalace logstream. Use when the user wants to delegate work, prepare a ready-to-paste task for another agent, receive a MemPalace task id, or explicitly launch a supported headless agent in controlled mode.