К основному содержанию
скилл CX Codex

cost-health — скилл для Claude Code: CI-гейт по расходам

Скилл cost-health гоняет четыре проверки расходов параллельно и отдаёт один статус: бюджет, ускорение трат, аномалии сессий и прогноз исчерпания.

MIT 249 установок ★ 82 234 обновлён 2026-11-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ruvnet/ruflo --skill cost-health -a claude-code
Открыть на GitHub

Что делает cost-health

Скилл собирает четыре отдельные проверки в одну команду cost health. budget смотрит, не пройден ли заданный бюджет, burn ищет ускорение дневных трат, anomaly ловит сессии-выбросы, projection считает дни до исчерпания. Все четыре стартуют разом через scripts/health.mjs, каждая отдаёт JSON, наружу выходит строка на проверку и общий бейдж HEALTHY или UNHEALTHY.

Код выхода — максимум из кодов подпроверок. Поэтому ошибка конфигурации (код 2) перебивает обычный алерт (код 1), и сломанный пайплайн не выглядит здоровым. У projection своего кода нет: его синтезируют из срока --alert-days-to-exhaust.

Пороги задаются флагами --alert-acceleration, --alert-outliers, --alert-days-to-exhaust. Флаг --skip burn,projection убирает медленные проверки. Если бюджет не настроен, projection просто пропускается — вердикта по ней не будет, и гейт этого не скрывает.

Какие задачи решает

  • свести четыре проверки расходов в один шаг CI
  • поймать сессию-выброс по z-оценке
  • узнать, через сколько дней кончится бюджет
  • пропустить медленную проверку на смоук-прогоне
  • отличить сломанную конфигурацию гейта от настоящего алерта

Примеры запросов агенту

  • Запусти cost health --alert-acceleration 100 --alert-outliers 1 и скажи, какая подпроверка упала.
  • Сделай быстрый смоук через cost health --skip burn.
  • Добавь в CI шаг cost health --alert-days-to-exhaust 30 для квартальной проверки.

Как установить cost-health

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

~/.claude/skills/cost-health/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cost-health/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cost-health

Как установить cost-health в Claude Code?

Одной командой: npx skills add ruvnet/ruflo --skill cost-health -a claude-code. Файл скилла появится по пути ~/.claude/skills/cost-health/SKILL.md.

Что делает cost-health?

Запускает проверки бюджета, ускорения трат, аномалий и прогноза в параллель и возвращает общий статус с самым строгим кодом выхода.

Что означают коды выхода?

0 — все подпроверки в норме, 1 — хотя бы один алерт, 2 — ошибка конфигурации или аргументов, 127 — подпроверка не запустилась.

Исходный текст

SKILL.md · MIT
---
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.
argument-hint: "[--alert-acceleration 100] [--alert-outliers 1] [--alert-days-to-exhaust 14] [--skip burn,anomaly] [--format table|json]"
allowed-tools: Bash
disable-model-invocation: true
---

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`](../../scripts/health.mjs).

1. Spawn all four subcheck scripts in parallel (`Promise.all` over `child_process.spawn`).
2. Each subcheck emits `--format json`; parse and capture exit code.
3. Projection has no built-in exit code — synthesize one from `daysUntilReached[100%] < --alert-days-to-exhaust`.
4. Final exit code = `max(subcheck exits)`. Any single failure fails the gate.
5. 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.

© ruvnet · MIT · ruvnet/ruflo

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
cost-accrual-tracker curiositech Скилл cost-accrual-tracker для Claude Code и пяти других платформ, который считает расходы на API в режиме реального времени во время выполнения LLM-запросов. Фиксирует частичные затраты даже при прерванных запросах. CX Codex +1 175установок ccam-cost-guard Son Nguyen Плагин ccam-cost-guard следит за расходами Claude Code, прогнозирует сумму к концу месяца и настраивает уведомления при достижении лимита. CX Codex ★ 1 198звёзд репо azure-cost-health-check Shayne Boyer Плагин azure-cost-health-check для GitHub Copilot показывает расходы Azure, прогнозы, бюджеты и рекомендации Advisor в одном канвасе. Включается в FinOps-мониторинг, чтобы проверить, куда уходят деньги. ★ 11звёзд репо deployment-health-monitor davila7 Хук deployment-health-monitor отслеживает статус деплоев в Vercel при старте сессии и после команд сборки. Предупреждает об ошибках и падении доли успешных релизов. 482установок dd-audit-cost-spike-investigation datadog-labs Скилл dd-audit-cost-spike-investigation для Claude Code сопоставляет Usage Metering Datadog с изменениями в Audit Trail. При расследовании скачка расходов выявляет изменения за предшествующие 24 часа. CX Codex +1 560установок firecrawl-cost-tuning Jeremy Longshore Скилл firecrawl-cost-tuning считает, куда уходят кредиты Firecrawl, и подбирает лимиты, форматы и кеш так, чтобы счёт стал меньше без потери качества данных. CX Codex +1 1установок

Из того же набора155

Весь набор →
gaia-architecture-comparison Скилл gaia-architecture-comparison для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который сравнивает harness ruflo с эталонной реализацией HAL от Princeton по девяти параметрам — от покрытия вопросов до исполнения кода. CX Codex +1 433установок nested-subagents Скилл nested-subagents для Claude Code строит дерево субагентов, где каждый ребёнок может породить своих детей. Разносит промежуточное состояние, не помещающееся в контекст одного агента. CX Codex +1 317установок cost-session Скилл cost-session для Claude Code детализирует затраты на каждое сообщение внутри сессии, показывая дорогие запросы. CX Codex +1 249установок cost-projection Скилл cost-projection для Claude Code прогнозирует расходы по недавним сессиям. Показывает темп трат, суммы на заданные периоды и срок до достижения лимита. CX Codex +1 249установок cost-counterfactual Скилл cost-counterfactual сравнивает реальные траты на сессии с гипотетическими сценариями always-haiku, always-sonnet и always-opus. Помогает понять, окупается ли роутер моделей. CX Codex +1 249установок cost-diff Скилл cost-diff для Claude Code сравнивает два JSON-снимка расходов. Запускается, чтобы проверить, увеличила ли PR-ветка затраты относительно базового снимка. CX Codex +1 248установок cost-burn Скилл cost-burn для Claude Code и других платформ, анализирующий ускорение трат на продакшене. Запускается в CI для проверки, не вышла ли скорость расходования средств за пределы среднего значения. CX Codex +1 248установок cost-anomaly Скилл cost-anomaly для Claude Code выявляет отдельные сессии с необычными расходами и показывает отклонение от типичных затрат. Запускается, когда нужно найти конкретную сессию-выброс, а не оценить общий тренд. CX Codex +1 248установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой