Agent skill

Cost Projection

by ruvnet in ruvnet/ruflo

Forward-looking spend extrapolation. An agent skill from ruvnet/ruflo.

MITAuto-check: notes

Install Cost Projection

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

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

GitHub CLI
$ gh skill install ruvnet/ruflo cost-projection --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-projection .claude/skills/cost-projection && 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
cost-projection
GitHub stars
74k
Token cost
~702 tokens
SKILL.md length
228 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Forward-looking spend extrapolation. An agent skill from ruvnet/ruflo.

  • Works in 5 steps: Read all session-* records from the… → Filter to a measurement window (default… → Compute the per-day burn rate:… → …
  • SKILL.md covers Algorithm, Flags, Smoke transcript (3 sessions ×… and When to use, plus 1 more section
  • Calls jq

What it does

Cost Projection is an agent skill from ruvnet/ruflo. Forward-looking spend extrapolation. Computes a USD-per-day rate from the recent measurement window, projects to 7d/30d/90d/365d horizons, and surfaces "days until budget exhausted" when a budget is configured. Predictive counterpart to cost-budget-check (reactive).

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

  • “days until budget exhausted”
  • “/cost-projection”

Requirements

  • Pre-approved tools (allowed-tools): Bash

Workflow steps

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

  1. Read all session-* records from the cost-tracking namespace (same source cost-budget-check uses).
  2. Filter to a measurement window (default last 7 days on capturedAt/startedAt).
  3. Compute the per-day burn rate: windowSpend / windowDays.
  4. Linear-extrapolate to each requested horizon (default 7d/30d/90d/365d).
  5. If a budget is configured (budget-config key set by cost-budget set)

What it can do on your machine

Read from SKILL.md and the folder at commit 58e0ae7. 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:

    • jq

    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 Projection loads about 702 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 228 words of instructions outside code blocks.

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

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 58e0ae7, republished under its MIT licence (© ruvnet). 228 words, ~702 tokens.

Download SKILL.mdSave it as .claude/skills/cost-projection/SKILL.md (or your agent's skills folder).
name
cost-projection
description
Forward-looking spend extrapolation. Computes a USD-per-day rate from the recent measurement window, projects to 7d/30d/90d/365d horizons, and surfaces "days until budget exhausted" when a budget is configured. Predictive counterpart to `cost-budget-check` (reactive).
allowed-tools
Bash
argument-hint
[--window 7d] [--horizons 7d,30d,90d,365d] [--format table|json]

Forward-looking cost projection that pairs with cost-budget-check:

  • cost-budget-check answers "have we crossed the line?" — reactive
  • cost-projection answers "when will we cross the line?" — predictive

Algorithm

  1. Read all session-* records from the cost-tracking namespace (same source cost-budget-check uses).
  2. Filter to a measurement window (default last 7 days on capturedAt/startedAt).
  3. Compute the per-day burn rate: windowSpend / windowDays.
  4. Linear-extrapolate to each requested horizon (default 7d/30d/90d/365d).
  5. If a budget is configured (budget-config key set by cost-budget set):
    • Compute "days until 75% / 90% / 100% consumed" at the current rate.
    • Surface as a separate table block with ALREADY REACHED markers for thresholds already exceeded.

Flags

--window <duration> Measurement window. Nh|Nd|Nw|Nm. Default 7d. --horizons <csv> Projection horizons. Default 7d,30d,90d,365d. --format table|json Default table (markdown).

Env: PROJECTION_NAMESPACE override (default cost-tracking), PROJECTION_QUIET=1 (alias for --format json).

Smoke transcript (3 sessions × $1 over 7d, $20 budget)

| Sessions in window | 3 |
| Window spend | $3.000000 |
| **USD per day** | **$0.428571** |
| All-time spend | $3.000000 across 3 sessions |

## Projected spend (linear extrapolation)
| Horizon | Days | Projected spend |
|---|---:|---:|
| 7d | 7 | $3.0000 |
| 30d | 30 | $12.8571 |

## Budget exhaustion ($20.00 configured)
| Threshold | Target | Remaining | Time at current rate |
|---|---:|---:|---|
| 75% | $15.00 | $12.00 | 28.0 days |
| 90% | $18.00 | $15.00 | 35.0 days |
| 100% | $20.00 | $17.00 | 39.7 days |

When to use

  • Finance / SRE planning: hand the JSON output to a budget dashboard for "are we on track for the quarter?".
  • CI gates: cost-projection --format json | jq '.budget.exhaustion[2].daysUntilReached < 7' → fail builds when 100% exhaustion is < 1 week away.
  • Post-workload-shift sanity check: after a big feature lands, re-run to verify the rate hasn't accelerated past expectations.

Stationarity assumption

Linear extrapolation assumes the current rate holds. The footer reminds operators to re-run after workload shifts. For drift detection over MULTIPLE windows, pair with cost-trend (which already covers benchmark-drift).

© ruvnet, 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 plugins/ruflo-cost-tracker/skills/cost-projection of ruvnet/ruflo.

Open the folder on GitHubat commit 58e0ae7

Compare with similar skills

Cost Projection 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 Projection compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cost Projection this skillruvnet/ruflo74k—~702Automated safety check: NotesMIT
Ito Computeaffaan-m/ECC276k1 repos~1.7kAutomated safety check: PassMIT
Find Project Anomaliespenpot/penpot61k—~1.2kAutomated safety check: PassMPL-2.0
Project Status Artifactanthropics/claude-plugins-official38k—~5.1kAutomated safety check: PassApache-2.0
Projects Work Managementsickn33/agentic-awesome-skills47k1 repos~4.1kAutomated safety check: PassMIT
HTML Ppt Zhangzara Daisy Daysnexu-io/open-design100k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Ito Compute

    affaan-m/ECC

    Query live GPU inventory, submit an authenticated Itô fixed-rate RFQ, inspect RFQ or procurement status, revoke device credentials, and run explicitly gated node qualification through the separately…

    276k GitHub starsUsed in 1 repo~1.7k tokens
    Business, Finance & HRAuto-check passed
  • Check a GitHub milestone against the Main project board, report the five anomaly types to tmp/<MILESTONE-ANOMALIES.md, and fix missing milestone assignments on request.

    61k GitHub stars~1.2k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Project Status Artifact

    anthropics/claude-plugins-official

    Official

    Builds and publishes a tabbed status page for a project with several workstreams, kept current by refreshing the same private page.

    38k GitHub stars~5.1k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Projects Work Management

    sickn33/agentic-awesome-skills

    Project register: owner, team, priority, progress percentage, milestones, deliverables and budget against actual cost.

    47k GitHub starsUsed in 1 repo~4.1k tokens
    Product & Project ManagementAuto-check passed
  • A customer-success workshop onboarding users to a project-management app — the first-value path and the habits that retain.

    100k GitHub stars~1.2k tokensUpdated today
    Sales & SupportAuto-check passed
  • Project Manager

    RightNow-AI/openfang

    Project management expert for Agile, estimation, risk management, and stakeholder communication

    18k GitHub stars~960 tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Questions about Cost Projection

What does Cost Projection do?

Forward-looking spend extrapolation. An agent skill from ruvnet/ruflo. Cost Projection is an agent skill from ruvnet/ruflo. Forward-looking spend extrapolation.

How do I install Cost Projection in Claude Code?

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

How do I install Cost Projection in Codex?

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

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

What does Cost Projection need to run?

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

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

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

About 702 tokens (SKILL.md is roughly 2.8k 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 Projection?

Skills that share tags, products or a category with Cost Projection: Ito Compute (affaan-m/ECC, 276k stars), Find Project Anomalies (penpot/penpot, 61k stars), Project Status Artifact (anthropics/claude-plugins-official, 38k stars) and Projects Work Management (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cost Projection?

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