cost-budget-check
Read accumulated cost-tracking spend + budget config, compute utilization, emit 50/75/90/100% alert ladder
Profile →npx skills add ruvnet/ruflo --skill cost-budget-check --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Cost Budget Check Reads `cost-tracking:budget-config` for the project's budget limit, sums `total_cost_usd` across `session-*` records produced by `cost-track`, computes utilization, and emits the **measured** 4-tier alert ladder (50% INFO / 75% WARNING / 90% CRITICAL / 100% HARD_STOP). Until P2 (this skill) landed, the README documented the alert ladder but no code checked it. Now this skill is the gate. ## When to use - After every cost-track run, to surface the alert level. - Before spawning a swarm — if utilization ≥ 90%, escalate to `/cost-optimize` first. - Cron-friendly via `/loop 30m` for continuous monitoring. ## Steps 1. **Run the check**: ```bash node plugins/ruflo-cost-tracker/scripts/budget.mjs check ``` Filter by period: `BUDGET_PERIOD=today` (default `all`). Use `BUDGET_QUIET=1` for machine-readable JSON. 2. **Inspect the markdown summary** — budget, spent, remaining, utilization percentage, alert level (🟢 OK · 🟡 INFO · 🟠 WARNING · 🔴 CRITICAL · 🛑 HARD_STOP), and the recommended action. 3. **Set / inspect the budget**: ```bash node plugins/ruflo-cost-tracker/scripts/budget.mjs set 50.00 node plugins/ruflo-cost-tracker/scripts/budget.mjs get ``` 4. **HARD_STOP p
- When to use
- Steps
- Storage shape (cost-tracking:budget-config)
- Alert ladder (from REFERENCE.md, now enforced)
- Cross-references
node plugins/ruflo-cost-tracker/scripts/budget.mjs check node plugins/ruflo-cost-tracker/scripts/budget.mjs set 50.00 node plugins/ruflo-cost-tracker/scripts/budget.mjs get
What does the cost-budget-check skill do?
Read accumulated cost-tracking spend + budget config, compute utilization, emit 50/75/90/100% alert ladder
How do I install it?
Run `npx skills add ruvnet/ruflo --skill cost-budget-check --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From ruvnet/ruflo, a repository with 67,015 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.