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

cost-anomaly — скилл для Claude Code: аномальные расходы

Скилл cost-anomaly для Claude Code выявляет отдельные сессии с необычными расходами и показывает отклонение от типичных затрат. Запускается, когда нужно найти конкретную сессию-выброс, а не оценить общий тренд.

MIT 248 установок ★ 82 234 обновлён 2026-10-25

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

Что делает 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-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Финансы и бизнес» →
anomaly-alert hoangsonww Скилл anomaly-alert находит аномальные сессии Claude Code по расходам и сбоям инструментов через локальный сервис Agent Monitor. CX Codex +1 ★ 1 198звёзд репо ccam-cost-guard Son Nguyen Хук ccam-cost-guard отслеживает расходы на Claude Code и отправляет данные о завершении сессий в дашборд Agent Monitor. CX Codex ★ 1 198звёзд репо Agent Cost Report thedotmack Скилл Agent Cost Report для Claude Code и Codex формирует отчёт о расходах агентов за выбранный период. Запускается при оценке затрат на сессии и поиске потерь от переделок или зацикливаний. CX Codex +1 816установок cost-tracker Rohit Ghumare Команда cost-tracker оценивает стоимость текущей сессии, показывает главные источники расходов и предлагает способы оптимизации. Пригодится, чтобы сверить траты с бюджетом задачи. CX Codex +1 ★ 2 966звёзд репо mcpspend-cost-tracking reason-machines Скилл mcpspend-cost-tracking для Claude Code отслеживает расходы на вызовы MCP-инструментов в реальном времени по инструментам, проектам и клиентам. Оборачивает MCP-серверы прозрачным прокси. CX Codex +1 117установок kibana-anomaly-detection elastic Скилл kibana-anomaly-detection помогает расследовать сбои в Elastic ML, разбирать оценки моделей и проверять упавшие datafeed. Пригодится при поиске первопричин инцидентов. CX Codex +1 3 500установок

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

Весь набор →
cost-session Скилл cost-session для Claude Code детализирует затраты на каждое сообщение внутри сессии, показывая дорогие запросы. CX Codex +1 249установок cost-projection Скилл cost-projection для Claude Code прогнозирует расходы по недавним сессиям. Показывает темп трат, суммы на заданные периоды и срок до достижения лимита. CX Codex +1 249установок cost-health Скилл cost-health гоняет четыре проверки расходов параллельно и отдаёт один статус: бюджет, ускорение трат, аномалии сессий и прогноз исчерпания. 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установок Ruflo MCP-сервер Ruflo для Claude Code и Codex координирует команды ИИ-агентов и хранит память между сессиями. После init хуки направляют задачи и запускают координацию в фоне. CX Codex +1 ★ 82 234звёзд репо claude-flow Подключает Claude Code к инструментам claude-flow для работы с агентами и координации задач. Для запуска через MCP понадобится ANTHROPIC_API_KEY. CX Codex +1 ★ 82 234звёзд репо

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

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