cost-projection — скилл для Claude Code: прогноз расходов
Скилл cost-projection для Claude Code прогнозирует расходы по недавним сессиям. Показывает темп трат, суммы на заданные периоды и срок до достижения лимита.
MIT 249 установок ★ 82 234 обновлён 2026-10-25
npx skills add ruvnet/ruflo --skill cost-projection -a claude-codeЧто делает cost-projection
Скилл читает записи сессий из пространства cost-tracking, берёт данные за измерительное окно и рассчитывает средние расходы в долларах за день. По этому темпу он строит линейный прогноз на 7d, 30d, 90d и 365d; окно и горизонты можно задать флагами. Результат выводится таблицей или в JSON.
Если настроен бюджет через cost-budget set, скилл рассчитывает, через сколько дней будут достигнуты пороги 75%, 90% и 100%, и отмечает уже пройденные. Для работы используются записи session-* и инструмент Bash. Линейный прогноз предполагает, что темп расходов не меняется; после смены нагрузки его нужно пересчитать.
Какие задачи решает
- спрогнозировать расходы на заданный период
- оценить, через сколько дней будет достигнут бюджетный порог
- передать прогноз расходов в бюджетную панель через JSON
- проверить, приблизился ли расход к полному исчерпанию бюджета
Примеры запросов агенту
- Рассчитай прогноз расходов на 30d по последним 7d и выведи JSON.
- Покажи, через сколько дней будут достигнуты пороги бюджета 75%, 90% и 100%.
- Спрогнозируй расходы на 7d, 30d и 90d в виде таблицы.
Как установить cost-projection
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-projection -a claude-code2Вручную: положить файлы
~/.claude/skills/cost-projection/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cost-projection/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-projection -a codex2Вручную: положить файлы
.agents/skills/cost-projection/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-projection -a cursor2Вручную: положить файлы
.cursor/skills/cost-projection/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo plugins/ruflo-cost-tracker/skills/cost-projection2Вручную: положить файлы
.github/skills/cost-projection/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-projection -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-cost-tracker/skills/cost-projectionВручную: положить файлы
.devin/skills/cost-projection/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-projection -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cost-projection
Как установить cost-projection в Claude Code?
Выполни npx skills add ruvnet/ruflo --skill cost-projection -a claude-code, затем открой ~/.claude/skills/cost-projection/SKILL.md.
Что делает cost-projection?
Скилл рассчитывает дневной темп расходов по записям недавних сессий и экстраполирует его на выбранные периоды. Если настроен бюджет, он также показывает время до достижения порогов.
Как cost-projection учитывает изменение темпа расходов?
Прогноз линейный и предполагает, что текущий темп сохранится. После изменения нагрузки прогноз нужно пересчитать.
Исходный текст
SKILL.md · MIT
--- 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). argument-hint: "[--window 7d] [--horizons 7d,30d,90d,365d] [--format table|json]" allowed-tools: Bash disable-model-invocation: true --- 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 · ruvnet/ruflo