cost-budget-check — скилл для Claude Code: бюджет и алерты
Считает, сколько проект уже потратил, сравнивает с лимитом и называет уровень тревоги: от INFO на 50% до HARD_STOP на 100%. Пригодится перед запуском новой пачки агентов.
npx skills add ruvnet/ruflo --skill cost-budget-check -a claude-codeЧто делает cost-budget-check
Скилл берёт лимит из cost-tracking:budget-config, суммирует total_cost_usd по записям session-*, которые оставляет cost-track, и выдаёт уровень: 50% INFO, 75% WARNING, 90% CRITICAL, 100% HARD_STOP. Раньше эта лестница жила только в README, проверять её было нечем. Теперь проверяет скилл.
Внутри один вызов: node plugins/ruflo-cost-tracker/scripts/budget.mjs check. Окно задаётся переменной BUDGET_PERIOD=today (по умолчанию all), BUDGET_QUIET=1 переключает вывод с markdown на JSON. Тот же скрипт ставит и показывает лимит: budget.mjs set 50.00 и budget.mjs get. Скиллу разрешены Bash и три инструмента памяти MCP.
На 100% скрипт выходит с кодом 1, поэтому связка budget.mjs check && spawn … падает закрытой. Это и есть смысл: сторож срабатывает до запуска, а не после счёта. Если использование перевалило за 90%, вход в /cost-optimize даст больше, чем ещё один прогон агентов. Для фонового контроля подойдёт /loop 30m.
Какие задачи решает
- узнать, сколько уже потрачено за месяц
- поймать момент, когда бюджет подходит к концу
- задать лимит в долларах и посмотреть остаток
- не дать запустить агентов при перерасходе
- повесить проверку бюджета в регулярный цикл
Примеры запросов агенту
- прогони cost-budget-check за сегодня
- сколько бюджета осталось? проверь перед запуском агентов
- поставь лимит 50.00 и покажи, какой сейчас уровень
Как установить cost-budget-check
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-budget-check -a claude-code2Вручную: положить файлы
~/.claude/skills/cost-budget-check/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cost-budget-check/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-budget-check -a codex2Вручную: положить файлы
.agents/skills/cost-budget-check/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-budget-check -a cursor2Вручную: положить файлы
.cursor/skills/cost-budget-check/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo cost-budget-check2Вручную: положить файлы
.github/skills/cost-budget-check/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-budget-check -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-cost-tracker/skills/cost-budget-checkВручную: положить файлы
.devin/skills/cost-budget-check/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-budget-check -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора104
Весь набор →Похожие
Вопросы о cost-budget-check
Как установить cost-budget-check в Claude Code?
Выполните npx skills add ruvnet/ruflo --skill cost-budget-check -a claude-code, скилл появится по пути ~/.claude/skills/cost-budget-check/SKILL.md.
Что делает cost-budget-check?
Читает накопленные траты из cost-track и лимит из cost-tracking:budget-config, считает процент использования и выдаёт уровень алерта от INFO до HARD_STOP с рекомендованным действием.
Что происходит при 100% бюджета?
Уровень HARD_STOP: budget.mjs check завершается с кодом 1, а несущественные запуски агентов стоит остановить. Если проверка стоит в цепочке через &&, запуск не пройдёт.
Исходный текст
SKILL.md · MIT
---
name: cost-budget-check
description: Read accumulated cost-tracking spend + budget config, compute utilization, emit 50/75/90/100% alert ladder
argument-hint: "[--period today|week|month|all]"
allowed-tools: Bash mcp__plugin_ruflo-core_ruflo__memory_retrieve mcp__plugin_ruflo-core_ruflo__memory_list mcp__plugin_ruflo-core_ruflo__memory_store
---
# 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 path** — `budget.mjs check` exits with code `1` when utilization ≥ 100%. Wrap critical agent spawns in a `budget.mjs check && spawn …` guard to fail closed.
## Storage shape (`cost-tracking:budget-config`)
```json
{
"budget_usd": 50.00,
"setAt": "2026-05-05T...",
"thresholds": { "info": 0.50, "warning": 0.75, "critical": 0.90, "hard_stop": 1.00 }
}
```
## Alert ladder (from REFERENCE.md, now enforced)
| Threshold | Level | Action |
|---|---|---|
| 50% | INFO 🟡 | log notification, no UX disruption |
| 75% | WARNING 🟠 | display warning, suggest `/cost-optimize` |
| 90% | CRITICAL 🔴 | urgent alert, recommend model downgrades |
| 100% | HARD_STOP 🛑 | halt non-essential spawns; exit code 1 |
## Cross-references
- `cost-track` (producer) — populates `cost-tracking:session-*`
- `cost-report` — same data source, narrative format
- `cost-optimize` — recommended action when WARNING/CRITICAL
- REFERENCE.md "Budget alert thresholds" — the documented ladder this enforces
© ruvnet · MIT · ruvnet/ruflo
