Agent skill

Cost Health

Composite CI gate — runs cost-budget-check + cost-burn + cost-anomaly + cost-projection in parallel and surfaces a single combined health status with max exit code.

MITAuto-check: notes

Install Cost Health

skills CLI

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

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

GitHub CLI

$ gh skill install ruvnet/ruflo cost-health --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-health .claude/skills/cost-health && 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-health" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-health into .claude/skills/cost-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-health", 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-health

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-health -a codex

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

GitHub CLI

$ gh skill install ruvnet/ruflo cost-health --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-health .agents/skills/cost-health && 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-health" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-health into .agents/skills/cost-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-health", 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-health -a cursor

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

GitHub CLI

$ gh skill install ruvnet/ruflo cost-health --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-health .cursor/skills/cost-health && 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-health" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-health into .cursor/skills/cost-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-health", 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-health

--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-health -a gemini-cli

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

GitHub CLI

$ gh skill install ruvnet/ruflo cost-health --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-health .gemini/skills/cost-health && 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-health" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-health into .gemini/skills/cost-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-health", 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-health

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-health -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-health .github/skills/cost-health && 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-health" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-health into .github/skills/cost-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-health", 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-health -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-health --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-health .opencode/skills/cost-health && 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-health" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-cost-tracker/skills/cost-health into .opencode/skills/cost-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-health", 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-health
GitHub stars: 74k
Token cost: ~901 tokens
SKILL.md length: 284 words
Files: 1
Skills in repo: 265
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Composite CI gate — runs cost-budget-check + cost-burn + cost-anomaly + cost-projection in parallel and surfaces a single combined health status with max exit code.

Works in 5 steps: Spawn all four subcheck scripts in… → Each subcheck emits --format json; parse… → Projection has no built-in exit code —… → …
SKILL.md covers Algorithm, CI integration, Customizing thresholds and Smoke transcript (5 healthy…, plus 2 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cost Health is an agent skill from ruvnet/ruflo. Composite CI gate — runs cost-budget-check + cost-burn + cost-anomaly + cost-projection in parallel and surfaces a single combined health status with max exit code. The operationally-useful entry point — one shell-out covers all four alert ladders.

Its SKILL.md is about 900 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.

Example prompts

“/cost-health”

Requirements

Node.js
Pre-approved tools (allowed-tools): Bash

Workflow steps

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

Spawn all four subcheck scripts in parallel (Promise.all over child_process.spawn).
Each subcheck emits --format json; parse and capture exit code.
Projection has no built-in exit code — synthesize one from daysUntilReached[100%] < --alert-days-to-exhaust.
Final exit code = max(subcheck exits). Any single failure fails the gate.
Print one-line summary per check + overall HEALTHY/UNHEALTHY badge.

What it can do on your machine

Read from SKILL.md and the folder at commit 6c04654. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and yaml).
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 Health loads about 901 tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 284 words of instructions outside code blocks.

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

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 6c04654, republished under its MIT licence (© ruvnet). 284 words, ~901 tokens.

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

name: cost-health
description: Composite CI gate — runs cost-budget-check + cost-burn + cost-anomaly + cost-projection in parallel and surfaces a single combined health status with max exit code. The operationally-useful entry point — one shell-out covers all four alert ladders.
allowed-tools: Bash
argument-hint: [--alert-acceleration 100] [--alert-outliers 1] [--alert-days-to-exhaust 14] [--skip burn,anomaly] [--format table|json]

The four CI-gate skills (budget / burn / anomaly / projection) each answer a different question. This skill composes them — runs all four IN PARALLEL, returns max(exit_codes), prints a one-line summary per check.

Subcheck	Question	Default threshold
`budget`	"Have we crossed the configured budget?"	HARD_STOP at 100%
`burn`	"Is daily burn accelerating?"	+100% vs prior-week mean
`anomaly`	"Is any specific session a >3.5σ outlier?"	≥1 outlier
`projection`	"When will we hit 100% of budget?"	<14 days

Algorithm

Implementation: scripts/health.mjs.

Spawn all four subcheck scripts in parallel (Promise.all over child_process.spawn).
Each subcheck emits --format json; parse and capture exit code.
Projection has no built-in exit code — synthesize one from daysUntilReached[100%] < --alert-days-to-exhaust.
Final exit code = max(subcheck exits). Any single failure fails the gate.
Print one-line summary per check + overall HEALTHY/UNHEALTHY badge.

CI integration

yaml

- name: Cost health gate
  run: cost health --alert-acceleration 100 --alert-outliers 1

A single step covers four alert ladders. Before this skill you'd wire four separate gates that each duplicated the npx + memory-list overhead; now it's one shell-out (and the four subcheck npx calls run in parallel internally).

Customizing thresholds

bash

# Quarterly review — stricter thresholds
cost health --alert-acceleration 50 --alert-outliers 1 --alert-days-to-exhaust 30

# Production drift gate — only fire on egregious changes
cost health --alert-acceleration 200 --alert-outliers 3 --alert-days-to-exhaust 7

# Skip the slow burn check during a smoke run
cost health --skip burn

Smoke transcript (5 healthy sessions, then add 1 outlier)

# Healthy
Overall: ✓ HEALTHY (max exit code 0)
| Check | Status | Detail |
| budget | ✓ | unknown — no budget configured |
| burn | ✓ | delta within ±100% |
| anomaly | ✓ | 0 outliers — under threshold ≥1 |
| projection | ✓ | no budget configured — skipping |

# After adding $5 outlier (vs $0.10 baseline)
Overall: ⚠ UNHEALTHY (max exit code 1)
| burn | ⚠ | ALERT 5163.2% acceleration: latest bucket $5.00 is 5163.2% above prior mean $0.095 |
| anomaly | ⚠ | ALERT 1 outlier (|z|>3.5) |

Skipping subchecks

bash

cost health --skip burn,projection   # only budget + anomaly

Useful when:

A subcheck doesn't apply (no budget set → skip projection)
A subcheck is too slow for fast-feedback contexts (smoke runs)
A subcheck is being independently CI-gated already

Exit code semantics

Exit	Meaning
0	All subchecks OK
1	At least one subcheck fired an alert (budget HARD_STOP, burn drift, anomaly outlier, projection imminent-exhaust)
2	A subcheck had a config/usage error (e.g. invalid CLI args propagated to a subscript)
127	A subcheck failed to launch (script missing, etc.)

max() means the worst signal wins — exit 2 (config error) always dominates exit 1 (alert), so you spot misconfigured pipelines before they masquerade as healthy.

Files

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

Open the folder on GitHubat commit 6c04654

Compare with similar skills

Cost Health 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 Health compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Cost Health this skillruvnet/ruflo	74k	—	~901	Automated safety check: Notes	MIT	yesterday
Cost Trackingaffaan-m/ECC	277k	1 repos	~1.3k	Automated safety check: Pass	MIT	today
Codebase Health Dashboardgarrytan/gstack	136k	—	~11k	Automated safety check: Notes	MIT	today
Token Budget Advisoraffaan-m/ECC	276k	—	~910	Automated safety check: Pass	MIT	yesterday
Token Budget Advisoraffaan-m/ECC	276k	—	~927	Automated safety check: Pass	MIT	yesterday
Budget Cash Flowsickn33/agentic-awesome-skills	47k	1 repos	~4.1k	Automated safety check: Pass	MIT	2 days ago

Similar skills

Cost Tracking
affaan-m/ECC
Track and report Claude Code token usage, spending, and budgets from the local ECC cost-tracker metrics log.
277k GitHub starsUsed in 1 repo~1.3k tokens
AI & LLM EngineeringAuto-check passed
Codebase Health Dashboard
garrytan/gstack
Runs a project's own type checker, linter, test runner, dead-code detector and shell linter, combines them into a weighted 0-10 score and tracks the trend.
136k GitHub stars~11k tokensUpdated today
DevelopmentAuto-check: notes
Token Budget Advisor
affaan-m/ECC
回答する前に、どれだけの回答深度を消費するかについてユーザーに情報に基づいた選択を提供する。ユーザーが回答の長さ、深さ、またはトークンバジェットを明示的に制御したい場合にこのスキルを使用する。トリガー条件："token budget", "token count", "token usage", "token limit", "response length", "answer depth"…
276k GitHub stars~910 tokensUpdated yesterday
AI & LLM EngineeringAuto-check passed
Token Budget Advisor
affaan-m/ECC
在回答前，为用户提供关于消耗多少响应深度的知情选择。当用户明确希望控制响应长度、深度或令牌预算时使用此技能。触发条件："token budget", "token count", "token usage", "token limit", "response length", "answer depth", "short version", "brief answer", "detailed…
276k GitHub stars~927 tokensUpdated yesterday
AI & LLM EngineeringAuto-check passed
Budget Cash Flow
sickn33/agentic-awesome-skills
Budget against actual by department, category and period, with budget and actual amounts, variance, percentage used and linked expenses.
47k GitHub starsUsed in 1 repo~4.1k tokens
Business, Finance & HRAuto-check passed
Cost Tracking
affaan-m/ECC
ローカルのコスト追跡データベースからClaude Codeのトークン使用量、支出、予算を追跡・レポートします。コスト、支出、使用量、トークン、予算、またはプロジェクト、ツール、セッション、日付によるコスト内訳について質問する場合に使用します。
276k GitHub stars~829 tokensUpdated yesterday
AI & LLM EngineeringAuto-check passed

Questions about Cost Health

What does Cost Health do?

Composite CI gate — runs cost-budget-check + cost-burn + cost-anomaly + cost-projection in parallel and surfaces a single combined health status with max exit code. Cost Health is an agent skill from ruvnet/ruflo. Composite CI gate — runs cost-budget-check + cost-burn + cost-anomaly + cost-projection in parallel and surfaces a single combined health status with max exit code.

How do I install Cost Health in Claude Code?

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

How do I install Cost Health in Codex?

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

Can I use Cost Health 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-health -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-health, .gemini/skills/cost-health, .github/skills/cost-health and .opencode/skills/cost-health in your project.

What does Cost Health need to run?

SKILL.md names no scripts, command-line tools or credentials: Cost Health is instructions for the agent only. Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash.

Does Cost Health 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 Health 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 Health use?

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

About 901 tokens (SKILL.md is roughly 3.6k 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 Health?

Skills that share tags, products or a category with Cost Health: Cost Tracking (affaan-m/ECC, 277k stars), Codebase Health Dashboard (garrytan/gstack, 136k stars), Token Budget Advisor (affaan-m/ECC, 276k stars) and Token Budget Advisor (affaan-m/ECC, 276k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cost Health?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,222 GitHub stars. The repository holds 265 skills in this directory. The repository was last updated on October 10, 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 Health

Install Cost Health

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Algorithm

CI integration

Customizing thresholds

Smoke transcript (5 healthy sessions, then add 1 outlier)

Skipping subchecks

Exit code semantics

Files

Compare with similar skills

Similar skills

Cost Tracking

Codebase Health Dashboard

Token Budget Advisor

Token Budget Advisor

Budget Cash Flow

Cost Tracking

More from ruvnet/ruflo

AgentDB Pattern Memory

Ruflo Multi-Agent Orchestration

Security Audit Scanner

SPARC Development Methodology

Swarm Orchestration

Add Model Descriptions

Questions about Cost Health