Agent skill

Basemind Usage Stats

by Goldziher in Goldziher/basemind

Shows a markdown dashboard of basemind activity in the session: tool call counts, top operations and estimated tokens saved against a grep and Read baseline.

MITAuto-check passedAgent Workflows

Install Basemind Usage Stats

skills CLI
$ npx skills add Goldziher/basemind --skill basemind-stats -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Goldziher/basemind basemind-stats --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Goldziher/basemind.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/basemind-stats .claude/skills/basemind-stats && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
basemind-stats
GitHub stars
108
Token cost
~558 tokens
SKILL.md length
240 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Shows a markdown dashboard of basemind activity in the session: tool call counts, top operations and estimated tokens saved against a grep and Read baseline.

  • Works in 4 steps: Call admin { "mode": "telemetry",… → Render a markdown block in this shape → If total_calls is 0, say so plainly ("no… → …
  • Checking how many basemind tool calls ran in the current session
  • SKILL.md covers When to use, How to run, When the user asks "--explain" and Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

When you ask what basemind has done or run `/bm-stats`, the agent calls the `admin` tool in `telemetry` mode for a time window (today by default, or 1h, 24h or all) and renders the response as a markdown report with the number of tool calls, the top operations and the estimated tokens saved against a hypothetical grep plus Read baseline. If there were no calls, it says so plainly and does not invent rows.

Token savings are always labeled as heuristics, with a closing sentence explaining that tools with no realistic baseline, such as memory, document search and git wrappers, report zero saved. Asking for `--explain` adds the per-baseline breakdown and names the estimator's source file. The skill is user-invoked only, so the dashboard is never shown automatically at the start of a conversation.

When your agent uses it

  • Checking how many basemind tool calls ran in the current session
  • Seeing which basemind operations are used most
  • Understanding how the estimated token savings number is derived

Example prompts

  • “Show me basemind stats for the last 24h.”
  • “How much is basemind helping in this session? Explain how the savings are calculated.”
  • “Run /bm-stats to see what the code-map tools have done so far in this session.”

Requirements

  • The basemind MCP server connected to the agent

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Call admin { "mode": "telemetry", "window": "today" } (the default). If the
  2. Render a markdown block in this shape
  3. If total_calls is 0, say so plainly ("no basemind activity in the window yet").
  4. Always disclose the savings model. Add one sentence at the end

What it can do on your machine

Read from SKILL.md and the folder at commit 2f6da31. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Basemind Usage Stats loads about 558 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 240 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~558

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Goldziher/basemind at commit 2f6da31, republished under its MIT licence (© Goldziher). 240 words, ~558 tokens.

Download SKILL.mdSave it as .claude/skills/basemind-stats/SKILL.md (or your agent's skills folder).
name
basemind-stats
description
Show a quick dashboard of basemind activity in this session: how many code-map tool calls have run, the per-tool histogram, and the estimated tokens saved vs a hypothetical grep+Read baseline. Use when the user asks "what has basemind done?", "how much is basemind helping?", "show me basemind stats", or invokes `/bm-stats` directly.

basemind-stats — on-demand usage dashboard

Call admin mode telemetry and render the result as a markdown report.

When to use

The user asks "what has basemind done?", "how much is basemind helping?", "show me basemind stats", or invokes /bm-stats directly. This skill is strictly user-invoked — see Notes.

How to run

  1. Call admin { "mode": "telemetry", "window": "today" } (the default). If the user asks for a specific range, map it to one of "today", "1h", "24h", "all".

  2. Render a markdown block in this shape:

    text
    ## basemind activity (today)
    - **N tool calls** ; top operations: code:outline (18), code:symbols (12), …
    - **~K tokens saved** vs grep + Read baseline
    - recent: code:outline (4ms, 312B), code:symbols (2ms, 180B), …
  3. If total_calls is 0, say so plainly ("no basemind activity in the window yet"). Don't pretend to have data.

  4. Always disclose the savings model. Add one sentence at the end:

    Savings are heuristics. Tools with no realistic baseline (memory, document search, git wrappers) report 0 saved — see the saved_baseline column on each row.

    The exact wording can vary; the principle (it's an estimate, here's why) cannot.

When the user asks "--explain"

If they invoke /bm-stats --explain or ask how the savings number is derived, include the per-baseline breakdown from the per_baseline field of the response and call out which tools fall into which bucket. The estimator lives in src/mcp/savings.rs if they want to read the code.

Notes

  • Don't auto-display the dashboard at the start of every conversation. This skill is strictly user-invoked.
  • Don't pad missing data. If recent is empty, say so; don't invent example rows.
  • Don't claim a token-savings number without the disclosure sentence.

© Goldziher, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/basemind-stats of Goldziher/basemind.

Open the folder on GitHubat commit 2f6da31

Compare with similar skills

Basemind Usage Stats next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Basemind Usage Stats compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Basemind Usage Stats this skillGoldziher/basemind108—~558Automated safety check: PassMIT
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence
Context Mode for Antigravity CLImksglu/context-mode26k—~850Automated safety check: PassCustom licence
Entroly Context Controljuyterman1000/entroly474—~501Automated safety check: PassApache-2.0
Authoringactiveing123/mcptoon218—~559Automated safety check: PassApache-2.0
Connectactiveing123/mcptoon218—~701Automated safety check: PassApache-2.0

Similar skills

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Routing rules for using context-mode MCP tools in Antigravity CLI: sandboxed code runs, file analysis, indexed search and web fetches that keep large output out of the conversation.

    26k GitHub stars~850 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Entroly Context Control

    juyterman1000/entroly

    Surgically select, compress, and recover codebase context using Entroly's MCP tools.

    474 GitHub stars~501 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Authoring

    activeing123/mcptoon

    Add or edit an MCP server entry in mcptoon's config correctly — stdio/streamable-http/sse shapes, command rules, placeholders, and validation.

    218 GitHub stars~559 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Connect

    activeing123/mcptoon

    Connect any AI agent to MCP servers through mcptoon — one config synced everywhere, one stdio gateway, 99.2% fewer tokens on tool discovery.

    218 GitHub stars~701 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Entroly Lobehub Audit

    juyterman1000/entroly

    Audit and remediate Entroly's MCP marketplace quality with evidence, adversarial validation, and no score gaming.

    474 GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Goldziher/basemind

All 10 skills in this repo
  • Basemind Code Context

    Goldziher/basemind

    Answers structural questions about a repository, such as where a symbol is defined, what calls it and what changed recently, through the basemind MCP server.

    108 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Basemind Index Scan

    Goldziher/basemind

    Builds or refreshes the basemind code index from the command line, for when basemind reports no index or its MCP server is not running.

    108 GitHub stars~997 tokensUpdated today
    Auto-check: warnings
  • Drives the basemind code-intelligence tool from the command line for symbol search, callers, git history and blame, document search and web crawling, sharing its cache with the MCP server.

    108 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Basemind Code Search

    Goldziher/basemind

    Answers where code is defined, who calls it and what shape a file has from a pre-built index, returning paths and line numbers instead of file contents.

    108 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Basemind Doctor

    Goldziher/basemind

    Diagnose and recover basemind when it isn't working — MCP tools missing or erroring, "no index" / "no indexed files", empty results that shouldn't be empty, or the MCP server seems dead.

    108 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Basemind Documents

    Goldziher/basemind

    Semantic + full-text search over documents and the web via basemind's RAG store — PDFs, Office, HTML, email, images (OCR), plus scraped/crawled web pages, with cross-encoder reranking, keyword and…

    108 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Basemind Usage Stats

What does Basemind Usage Stats do?

Shows a markdown dashboard of basemind activity in the session: tool call counts, top operations and estimated tokens saved against a grep and Read baseline. When you ask what basemind has done or run `/bm-stats`, the agent calls the `admin` tool in `telemetry` mode for a time window (today by default, or 1h, 24h or all) and renders the response as a markdown report with the number of tool calls, the top operations and the estimated tokens saved against a hypothetical grep plus Read baseline. If there were no calls, it says so plainly and does not invent rows.

When should I use Basemind Usage Stats?

Basemind Usage Stats fits situations like: checking how many basemind tool calls ran in the current session; seeing which basemind operations are used most; understanding how the estimated token savings number is derived.

How do I install Basemind Usage Stats in Claude Code?

Run `npx skills add Goldziher/basemind --skill basemind-stats -a claude-code`. Or copy the skill folder (skills/basemind-stats in Goldziher/basemind) into .claude/skills/basemind-stats in your project. Claude Code loads it when a task matches its description.

How do I install Basemind Usage Stats in Codex?

Run `npx skills add Goldziher/basemind --skill basemind-stats -a codex`. Or copy the skill folder (skills/basemind-stats in Goldziher/basemind) into .agents/skills/basemind-stats in your project. Codex loads it when a task matches its description.

Can I use Basemind Usage Stats in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Goldziher/basemind --skill basemind-stats -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/basemind-stats, .gemini/skills/basemind-stats, .github/skills/basemind-stats and .opencode/skills/basemind-stats in your project.

What does Basemind Usage Stats need to run?

SKILL.md names no scripts, command-line tools or credentials: Basemind Usage Stats is instructions for the agent only. Our summary lists: The basemind MCP server connected to the agent.

Does Basemind Usage Stats access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Basemind Usage Stats safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Basemind Usage Stats use?

Basemind Usage Stats is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Basemind Usage Stats use?

About 558 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Basemind Usage Stats?

Skills that share tags, products or a category with Basemind Usage Stats: Context Mode Output Sandbox (mksglu/context-mode, 26k stars), Context Mode for Antigravity CLI (mksglu/context-mode, 26k stars), Entroly Context Control (juyterman1000/entroly, 474 stars) and Authoring (activeing123/mcptoon, 218 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Basemind Usage Stats?

Goldziher (a GitHub user) maintains it in Goldziher/basemind, which has 108 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 10, 2026.

Source: Goldziher/basemind on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.