cost-anomaly — скилл для Claude Code: аномальные расходы
Скилл cost-anomaly для Claude Code выявляет отдельные сессии с необычными расходами и показывает отклонение от типичных затрат. Запускается, когда нужно найти конкретную сессию-выброс, а не оценить общий тренд.
MIT 248 установок ★ 82 234 обновлён 2026-10-25
npx skills add ruvnet/ruflo --skill cost-anomaly -a claude-codeЧто делает cost-anomaly
Скилл анализирует расходы по отдельным сессиям из пространства имён cost-tracking и выводит аномальные значения с модифицированной z-оценкой. Для поиска выбросов он использует медиану и MAD; порог можно задать через --threshold, а период — через --since. Результат выводится в таблице или JSON с помощью --format.
Флаг --alert-on-outliers задаёт порог количества выбросов для кода завершения, что позволяет подключить проверку к CI. При числе сессий меньше трёх скилл сообщает о недостатке данных и завершает работу с кодом 0. Если MAD равен нулю, вместо деления на ноль выводится пояснение.
Какие задачи решает
- найти отдельные сессии с аномальными расходами
- сравнить затраты сессии с медианой остальных
- завершить проверку CI с ошибкой при заданном числе выбросов
- различить сессии с высокими и низкими отклонениями
Примеры запросов агенту
- Найди сессии с аномальными расходами за последние 7 дней.
- Покажи отдельные сессии-выбросы и их z-оценки в формате JSON.
- Заверши проверку с ошибкой, если найдётся хотя бы один выброс.
Как установить cost-anomaly
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-anomaly -a claude-code2Вручную: положить файлы
~/.claude/skills/cost-anomaly/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cost-anomaly/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-anomaly -a codex2Вручную: положить файлы
.agents/skills/cost-anomaly/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-anomaly -a cursor2Вручную: положить файлы
.cursor/skills/cost-anomaly/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo plugins/ruflo-cost-tracker/skills/cost-anomaly2Вручную: положить файлы
.github/skills/cost-anomaly/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-anomaly -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-cost-tracker/skills/cost-anomalyВручную: положить файлы
.devin/skills/cost-anomaly/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-anomaly -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cost-anomaly
Как установить cost-anomaly в Claude Code?
Выполни npx skills add ruvnet/ruflo --skill cost-anomaly -a claude-code. Файл скилла находится по пути ~/.claude/skills/cost-anomaly/SKILL.md.
Что делает cost-anomaly?
Он ищет сессии с аномальными расходами, сравнивая стоимость каждой с медианой и MAD, и показывает модифицированные z-оценки. Для запуска проверки в CI есть флаг --alert-on-outliers.
Что происходит, если сессий меньше трёх?
Скилл сообщает, что данных недостаточно, и завершает работу с кодом 0.
Исходный текст
SKILL.md · MIT
--- name: cost-anomaly description: "MAD-based outlier detection on session spend: lists anomalous sessions with modified-z scores, with an optional --alert-on-outliers exit code for CI. Use when asked which individual session is the cost outlier; cost-burn covers the aggregate trend." argument-hint: "[--since 7d] [--threshold 3.5] [--alert-on-outliers N] [--format table|json]" allowed-tools: Bash disable-model-invocation: true --- Per-session outlier detection — the diagnostic counterpart to cost-burn's aggregate-trend signal. | Question | Skill | |---|---| | "Is the AGGREGATE rate accelerating?" | `cost-burn` | | "Which SPECIFIC sessions are anomalous outliers?" | **`cost-anomaly`** ← this | | "Could we have spent less in aggregate?" | `cost-counterfactual` | | "When will we hit budget?" | `cost-projection` | ## Algorithm Implementation: [`scripts/anomaly.mjs`](../../scripts/anomaly.mjs). 1. Read all `session-*` records from `cost-tracking` namespace. 2. Filter to `--since` window (default: all-time). 3. Compute `median(total_cost_usd)` and `MAD = median(|x - median|)`. 4. Per-session modified z-score (Iglewicz-Hoaglin 1993): `z = 0.6745 * (x - median) / MAD` 5. Flag sessions with `|z| > --threshold` (default 3.5). ## Why MAD and not mean + sigma? | Approach | What breaks | |---|---| | `mean + sigma` | A single $50 session inflates BOTH mean and sigma so badly that subsequent outliers hide inside the new "normal" band. Catastrophic on small samples. | | `median + MAD` | Both estimators ignore up to 50% of the data — the outliers themselves can't shift them. Robust on n=10. The canonical cutoff `\|z\| > 3.5` is from Iglewicz-Hoaglin (1993). | ## Smoke transcript (5 baseline sessions $0.08-$0.12 + 1 outlier $5.00) ``` | Sessions considered | 5 | | Threshold (|modified z|) | 3.5 | | Median spend | $0.100000 | | MAD | $0.010000 | | Min / Max | $0.080000 / $5.000000 | | **Outliers found** | **1** | ## Outlier sessions | Session | Spend | Deviation | Modified z | Direction | | outlier- | $5.000000 | +$4.900000 | 330.505 | high | ``` ## Exit codes ``` $ cost anomaly --alert-on-outliers 1 ⚠ ALERT: found 1 outlier session(s) (|modified z| > 3.5); threshold was ≥1 exit 1 $ cost anomaly --alert-on-outliers 5 ✓ found 1 outlier session(s); under threshold ≥5 — OK exit 0 ``` ## CI integration ```bash # Fail the build if any session this week is a >3.5σ outlier cost anomaly --since 7d --alert-on-outliers 1 || investigate-bad-session ``` Most useful when paired with `cost-burn`: ```bash cost burn --alert-on-acceleration-pct 50 || page-oncall # rate-of-change alert cost anomaly --alert-on-outliers 1 || investigate # point-anomaly alert ``` Together they cover "is the average shifting?" AND "is there a single rogue session?" — both can fire independently. ## Edge cases - **n < 3**: emit "Insufficient data" message, exit 0. MAD on 1-2 samples is meaningless. - **MAD = 0**: ≥50% of sessions share the exact same spend, so z-scores collapse. Emit explainer instead of dividing by zero. Common cause: dry-run sessions all at $0. - **Low-direction outliers**: usually crashed or dropped sessions, not over-spending. The output table explicitly labels direction so operators interpret correctly. - **Very small MAD**: even tiny absolute deviations produce huge z-scores. The $5 outlier with MAD=$0.01 yields z=330 — that's correct, not a bug. ## Direction column | Direction | Likely cause | Action | |---|---|---| | `high` | Long session, stuck in expensive tier, or runaway loop | `cost report` + `cost conversation` to investigate | | `low` | Crash, dropped session, or unfinished work | Verify the session completed normally |
© ruvnet · MIT · ruvnet/ruflo