Agent skill

Cost Summary

Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate.

MITAuto-check: notes

Install Cost Summary

skills CLI

$ npx skills add ruvnet/ruflo --skill cost-summary -a claude-code

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

GitHub CLI

$ gh skill install ruvnet/ruflo cost-summary --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/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruflo-cost-tracker/skills/cost-summary .claude/skills/cost-summary && 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/

Paste into Claude Code

Install the "cost-summary" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-summary into .claude/skills/cost-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-summary", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-summary

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ruvnet/ruflo --skill cost-summary -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo cost-summary --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/ruflo-cost-tracker/skills/cost-summary .agents/skills/cost-summary && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "cost-summary" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-summary into .agents/skills/cost-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-summary", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/ruflo --skill cost-summary -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo cost-summary --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/ruflo-cost-tracker/skills/cost-summary .cursor/skills/cost-summary && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "cost-summary" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-summary into .cursor/skills/cost-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-summary", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ruvnet/ruflo.git --path plugins/ruflo-cost-tracker/skills/cost-summary

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ruvnet/ruflo --skill cost-summary -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo cost-summary --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/ruflo-cost-tracker/skills/cost-summary .gemini/skills/cost-summary && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "cost-summary" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-summary into .gemini/skills/cost-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-summary", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ruvnet/ruflo cost-summary

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ruvnet/ruflo --skill cost-summary -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/ruflo-cost-tracker/skills/cost-summary .github/skills/cost-summary && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "cost-summary" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-summary into .github/skills/cost-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-summary", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/ruflo --skill cost-summary -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo cost-summary --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/ruflo-cost-tracker/skills/cost-summary .opencode/skills/cost-summary && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "cost-summary" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-summary into .opencode/skills/cost-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-summary", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: cost-summary
GitHub stars: 74k
Used in: 1 other repo
Token cost: ~594 tokens
SKILL.md length: 141 words
Files: 1
Skills in repo: 264
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate.

Tasks that involve LLM cost and token optimization
SKILL.md covers When to use, Output contract (JSON, stable), Steps and Cross-references
Calls node

What it does

Cost Summary is an agent skill from ruvnet/ruflo. Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate. JSON or markdown.

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

Tasks that involve LLM cost and token optimization

Example prompts

“/cost-summary”

Requirements

Pre-approved tools (allowed-tools): Bash

What it can do on your machine

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

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- node
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

Cost Summary loads about 594 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 141 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Bash
```

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 ruvnet/ruflo at commit 6051f67, republished under its MIT licence (© ruvnet). 141 words, ~594 tokens.

Download SKILL.mdSave it as .claude/skills/cost-summary/SKILL.md (or your agent's skills folder).

name: cost-summary
description: Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate. JSON or markdown.
allowed-tools: Bash
argument-hint: [--format json|markdown]

Cost Summary

A stable single-call interface that other plugins / scripts / dashboards can shell out to and parse. ADR-0002 considered exposing cost_report / cost_summary as proper MCP tools but deferred that — adding MCP tools requires modifying @claude-flow/cli source, out of scope for plugin-local work. This script is the equivalent: same data, exposed via a stdout JSON contract.

When to use

Another plugin needs a snapshot of cost state — it shells out to summary.mjs --format json and parses.
A dashboard / Slackbot fetches a one-line cost rollup.
Quick "where am I right now?" view that pulls from every cost-tracker source (cost-tracking + federation-spend).

Output contract (JSON, stable)

json

{
  "exportedAt": "<ISO>",
  "total_cost_usd": 1546.36,
  "sessionCount": 1,
  "conversationCount": 1,
  "byTier": { "haiku": 0, "sonnet": 0, "opus": 1546.36, "unknown": 0 },
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "cost_usd": 1546.36,
      "messages": 1597,
      "input_tokens": 3090,
      "output_tokens": 3295940,
      "cache_creation_input_tokens": 10659599,
      "cache_read_input_tokens": 732833690
    }
  },
  "topSession": {
    "sessionId": "1dba3b8c-...",
    "total_cost_usd": 1546.36,
    "messageCount": 1597
  },
  "budget": {
    "budget_usd": 2500.00,
    "setAt": "<ISO>",
    "spent_usd": 1546.36,
    "utilization": 0.6185,
    "level": "INFO"
  },
  "federation": {
    "eventCount": 0,
    "peerCount": 0,
    "totalUsd24h": 0
  }
}

Steps

bash

# Markdown (default)
node plugins/ruflo-cost-tracker/scripts/summary.mjs

# JSON for programmatic consumption
node plugins/ruflo-cost-tracker/scripts/summary.mjs --format json

Optional env: SUMMARY_NAMESPACE=cost-tracking, SUMMARY_FED_NAMESPACE=federation-spend, SUMMARY_FORMAT=json.

Cross-references

cost-report — narrative report (per-agent / per-model lens; uses same data)
cost-export — pushes to Prometheus / webhook (this skill is pull-style; export is push-style)
ADR-0002 §"Decision" — explicitly defers proper MCP-tool registration to a future ADR

Files

Just SKILL.md in plugins/ruflo-cost-tracker/skills/cost-summary of ruvnet/ruflo.

Open the folder on GitHubat commit 6051f67

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ruvnet/ruflo, which our catalogue first saw on October 7, 2026.

majiayu000/claude-skill-registryskills/bash/cost-summary

Compare with similar skills

Cost Summary 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.

Cost Summary compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Cost Summary this skillruvnet/ruflo	74k	1 repos	~594	Automated safety check: Notes	MIT	today
Defuddlekepano/obsidian-skills	49k	12 repos	~208	Automated safety check: Pass	MIT	23 days ago
Caveman Workflow LabelerJuliusBrussee/caveman	110k	1 repos	~1.3k	Automated safety check: Pass	Apache-2.0	today
Caveman Evidence ReviewJuliusBrussee/caveman	110k	1 repos	~927	Automated safety check: Pass	Apache-2.0	today
Caveman Optimization EvaluatorJuliusBrussee/caveman	110k	1 repos	~1.2k	Automated safety check: Pass	Apache-2.0	today
Copilot Session Failure Analysisdotnet/maui	23k	—	~3.4k	Automated safety check: Pass	MIT	yesterday

Similar skills

Defuddle
kepano/obsidian-skills
Uses the Defuddle CLI to pull clean, readable Markdown, JSON or metadata from web pages, stripping navigation, ads and clutter to save tokens.
49k GitHub starsUsed in 12 repos~208 tokens
Knowledge ManagementAuto-check passed
Caveman Workflow Labeler
JuliusBrussee/caveman
Finds every LLM workflow in a repository, proposes a labeling table and, once you agree, wires labels so Caveman Cloud groups spend per workflow.
110k GitHub starsUsed in 1 repo~1.3k tokens
AI & LLM EngineeringAuto-check passed
Caveman Evidence Review
JuliusBrussee/caveman
Read-only review of Caveman Cloud data to explain where LLM spend goes: cost, score, workflows, traces, latency, errors, routing and verified savings.
110k GitHub starsUsed in 1 repo~927 tokens
AI & LLM EngineeringAuto-check passed
Caveman Optimization Evaluator
JuliusBrussee/caveman
Turns a Caveman report-only optimization observation into one minimal code change and a paired baseline evaluation, after the operator picks which to pursue.
110k GitHub starsUsed in 1 repo~1.2k tokens
AI & LLM EngineeringAuto-check passed
Copilot Session Failure Analysis
dotnet/maui
Official
Mines local Copilot CLI session logs for dotnet/maui to rank costly or failing runs, tag recurring failure modes, propose repo edits and emit guard evals.
23k GitHub stars~3.4k tokensUpdated yesterday
Agent WorkflowsAuto-check passed
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 yesterday
Agent WorkflowsAuto-check passed

Questions about Cost Summary

What does Cost Summary do?

Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate. Cost Summary is an agent skill from ruvnet/ruflo. Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate.

When should I use Cost Summary?

Cost Summary fits situations like: tasks that involve LLM cost and token optimization.

How do I install Cost Summary in Claude Code?

Run `npx skills add ruvnet/ruflo --skill cost-summary -a claude-code`. Or copy the skill folder (plugins/ruflo-cost-tracker/skills/cost-summary in ruvnet/ruflo) into .claude/skills/cost-summary in your project. Claude Code loads it when a task matches its description.

How do I install Cost Summary in Codex?

Run `npx skills add ruvnet/ruflo --skill cost-summary -a codex`. Or copy the skill folder (plugins/ruflo-cost-tracker/skills/cost-summary in ruvnet/ruflo) into .agents/skills/cost-summary in your project. Codex loads it when a task matches its description.

Can I use Cost Summary 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 ruvnet/ruflo --skill cost-summary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cost-summary, .gemini/skills/cost-summary, .github/skills/cost-summary and .opencode/skills/cost-summary in your project.

What does Cost Summary need to run?

Going by SKILL.md and its folder, Cost Summary needs the command-line tools its instructions call (node). Its frontmatter pre-approves these tools: Bash.

Does Cost Summary 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 Cost Summary safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Cost Summary use?

Cost Summary 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 Cost Summary use?

About 594 tokens (SKILL.md is roughly 2.4k 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 Cost Summary?

Skills that share tags, products or a category with Cost Summary: Defuddle (kepano/obsidian-skills, 49k stars), Caveman Workflow Labeler (JuliusBrussee/caveman, 110k stars), Caveman Evidence Review (JuliusBrussee/caveman, 110k stars) and Caveman Optimization Evaluator (JuliusBrussee/caveman, 110k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cost Summary?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,089 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 8, 2026.

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

Cost Summary

Install Cost Summary

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Cost Summary

When to use

Output contract (JSON, stable)

Steps

Cross-references

Files

Used in 1 other repository

Compare with similar skills

Similar skills

Defuddle

Caveman Workflow Labeler

Caveman Evidence Review

Caveman Optimization Evaluator

Copilot Session Failure Analysis

Context Mode Output Sandbox

More from ruvnet/ruflo

AgentDB Pattern Memory

Security Audit Scanner

SPARC Development Methodology

Swarm Orchestration

Ruflo Multi-Agent Orchestration

Agent Coordination

Questions about Cost Summary