cost-summary — скилл для Claude Code: что делает и как установить
Скилл выгружает сводку расходов на модели и сессии в формате JSON или markdown. Пригодится для ботов, скриптов или быстрой проверки бюджета.
npx skills add ruvnet/ruflo --skill cost-summary -a claude-codeЧто делает cost-summary
Скрипт собирает данные из модулей cost-tracking и federation-spend. В отчёт попадают общие затраты в долларах, разбивка по тарифам вроде Haiku, Sonnet или Opus, данные по конкретным моделям, самая затратная сессия и статус бюджета с процентом утилизации. По умолчанию вывод даётся в формате markdown, а флаг --format json возвращает структурированный объект в stdout.
Внутри скилл вызывает скрипт через Bash: node plugins/ruflo-cost-tracker/scripts/summary.mjs. Разработчики отложили регистрацию полноценного MCP-инструмента по решению ADR-0002, так как это потребовало бы правок в коде @claude-flow/cli. Для работы нужен установленный Node.js. Переопределить параметры можно через переменные окружения SUMMARY_NAMESPACE, SUMMARY_FED_NAMESPACE и SUMMARY_FORMAT.
Какие задачи решает
- выгрузить общие расходы на вызовы моделей в JSON для дашборда или бота
- проверить текущий статус и процент утилизации лимита бюджета
- найти самую дорогую сессию и распределение токенов по моделям
- получить сводку трат без подключения к Prometheus или вебхукам
Примеры запросов агенту
- Выведи текущую сводку расходов на модели в markdown
- Сделай дамп затрат через cost-summary --format json
Как установить cost-summary
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-summary -a claude-code2Вручную: положить файлы
~/.claude/skills/cost-summary/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cost-summary/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-summary -a codex2Вручную: положить файлы
.agents/skills/cost-summary/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-summary -a cursor2Вручную: положить файлы
.cursor/skills/cost-summary/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo cost-summary2Вручную: положить файлы
.github/skills/cost-summary/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-summary -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-cost-tracker/skills/cost-summaryВручную: положить файлы
.devin/skills/cost-summary/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-summary -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора104
Весь набор →Похожие
Вопросы о cost-summary
Как установить cost-summary в Claude Code?
Выполните команду npx skills add ruvnet/ruflo --skill cost-summary -a claude-code.
Что делает скилл cost-summary?
Он собирает агрегированные траты на токены из трекера расходов и выводит отчёт по моделям, сессиям и бюджетам в формате JSON или markdown.
Почему cost-summary сделан как скрипт, а не инструмент MCP?
Согласно архитектурному решению ADR-0002, добавление инструментов MCP потребовало бы правок в исходниках @claude-flow/cli. Скилл обращается к скрипту через Bash и читает JSON напрямую из stdout.
Исходный текст
SKILL.md · MIT
---
name: cost-summary
description: Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate. JSON or markdown.
argument-hint: "[--format json|markdown]"
allowed-tools: Bash
---
# Cost Summary
A stable single-call interface that other plugins / scripts / dashboards can shell out to and parse. ADR-0002 considered exposing `cost_report` / `cost_summary` as proper MCP tools but **deferred that** — adding MCP tools requires modifying `@claude-flow/cli` source, out of scope for plugin-local work. This script is the equivalent: same data, exposed via a stdout JSON contract.
## When to use
- Another plugin needs a snapshot of cost state — it shells out to `summary.mjs --format json` and parses.
- A dashboard / Slackbot fetches a one-line cost rollup.
- Quick "where am I right now?" view that pulls from every cost-tracker source (cost-tracking + federation-spend).
## Output contract (JSON, stable)
```json
{
"exportedAt": "<ISO>",
"total_cost_usd": 1546.36,
"sessionCount": 1,
"conversationCount": 1,
"byTier": { "haiku": 0, "sonnet": 0, "opus": 1546.36, "unknown": 0 },
"byModel": {
"claude-opus-4-7": {
"tier": "opus",
"cost_usd": 1546.36,
"messages": 1597,
"input_tokens": 3090,
"output_tokens": 3295940,
"cache_creation_input_tokens": 10659599,
"cache_read_input_tokens": 732833690
}
},
"topSession": {
"sessionId": "1dba3b8c-...",
"total_cost_usd": 1546.36,
"messageCount": 1597
},
"budget": {
"budget_usd": 2500.00,
"setAt": "<ISO>",
"spent_usd": 1546.36,
"utilization": 0.6185,
"level": "INFO"
},
"federation": {
"eventCount": 0,
"peerCount": 0,
"totalUsd24h": 0
}
}
```
## Steps
```bash
# Markdown (default)
node plugins/ruflo-cost-tracker/scripts/summary.mjs
# JSON for programmatic consumption
node plugins/ruflo-cost-tracker/scripts/summary.mjs --format json
```
Optional env: `SUMMARY_NAMESPACE=cost-tracking`, `SUMMARY_FED_NAMESPACE=federation-spend`, `SUMMARY_FORMAT=json`.
## Cross-references
- `cost-report` — narrative report (per-agent / per-model lens; uses same data)
- `cost-export` — pushes to Prometheus / webhook (this skill is pull-style; export is push-style)
- ADR-0002 §"Decision" — explicitly defers proper MCP-tool registration to a future ADR
© ruvnet · MIT · ruvnet/ruflo
