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

error-propagation — скилл для Claude Code: что делает и как установить

Скилл error-propagation находит, на какой глубине мультиагентной сессии возникла ошибка и как она докатилась до родительских агентов.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-workflows@claude-code-agent-monitor-plugins
Открыть на GitHub

Что делает error-propagation

Скилл разбирает провал мультиагентного запуска по глубине дерева агентов. Он берёт набор errorPropagation из GET /api/workflows/{sessionId} — там ошибки уже сгруппированы по глубине с указанием, где они зародились и по какому пути поднялись к родителям — и сверяет его с потоком событий из GET /api/events?session_id={sessionId}: APIError, SubagentStop, падающие PostToolUse.

Отчёт состоит из пяти частей: сводка по числу ошибок и затронутых агентов, таблица «ошибки по глубине» (возникли на этом уровне или унаследованы от детей), цепочки каскада вида debugger (depth 2, tool failure) → code-review (depth 1, marked error) → root (depth 0, aborted), таксономия ошибок по типу и оценка, была ли ошибка локализована или пробила весь путь до родителя. Если сессия без ошибок, скилл прямо сообщает об этом и останавливается, ничего не выдумывая.

Без запущенного дашборда Agent Monitor (npm start из корня репозитория) скилл работать не будет: он опирается на эти два эндпоинта API.

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

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

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

  • Разберись, почему последняя сессия агентов завершилась с ошибкой
  • Проследи, как ошибка в сабагенте debugger докатилась до root
  • Покажи таксономию ошибок для сессии session-42

Как установить error-propagation

1Через маркетплейс плагинов

/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-workflows@claude-code-agent-monitor-plugins

Команда ставит плагин ccam-workflows целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill error-propagation -a claude-code

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

~/.claude/skills/error-propagation/SKILL.md

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

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

Вопросы об error-propagation

Как установить error-propagation в Claude Code?

Через маркетплейс: сначала /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, затем /plugin install ccam-workflows@claude-code-agent-monitor-plugins.

Что делает error-propagation?

Скилл трассирует ошибки мультиагентной сессии по глубине дерева агентов: где они возникли, как каскадом дошли до родителей, и какие инструменты чаще всего падают. Данные берутся из workflow intelligence API и потока событий сессии.

Что нужно для работы error-propagation?

Нужен запущенный дашборд Agent Monitor — скилл подключается к GET /api/workflows/{sessionId} и GET /api/events?session_id={sessionId}; без него он советует запустить npm start из корня репозитория.

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

SKILL.md · MIT
---
name: error-propagation
description: >
  Trace error propagation through a multi-agent session by agent depth — where
  failures originated, the depth at which they appeared, and how they cascaded
  up to parent agents — using the Agent Monitor workflow intelligence API and
  the session event stream. Use when a multi-agent run failed and you need to
  find the origin and blast radius of the failure.
---

# Error Propagation

Trace where a multi-agent session's failures started and how far they spread.

## Input

The user provides: **$ARGUMENTS**

A session ID. If empty, fetch `GET /api/sessions?limit=1`, but prefer the most recent session whose `status` is `error` or `abandoned`; state which one you picked.

## Data Sources

| Endpoint | Returns |
|----------|---------|
| `GET /api/workflows/{sessionId}` | The `errorPropagation` dataset: failures grouped by agent depth, with originating depth and cascade paths to parents |
| `GET /api/events?session_id={sessionId}` | The event stream — corroborate with `APIError`, `SubagentStop`, and failing `PostToolUse` events (`event_type`, `tool_name`, `summary`, `timestamp`) |

## Report Sections

### 1. Failure Summary
From `errorPropagation`: total errors, the depth where the first error originated, and how many distinct agents were affected.
`Origin depth: d · Errors: N · Agents affected: M`

### 2. Errors by Depth
| Depth | Errors originated | Errors inherited from children | Net failing agents |
|-------|-------------------|--------------------------------|--------------------|
Show whether failures concentrate deep in the tree (leaf subagents) or shallow (orchestrator).

### 3. Cascade Paths
For each originating failure, the path it propagated along:
`debugger (depth 2, tool failure) → code-review (depth 1, marked error) → root (depth 0, aborted)`
Tie each step to a concrete event from `/api/events` (event_type + tool_name + timestamp) where available.

### 4. Error Taxonomy
Break errors down by type from the event stream: `APIError` vs failing tool calls vs `SubagentStop` with error status. Note the most frequent tool involved in failures.

### 5. Containment Assessment
Whether failures were contained at the depth where they originated or leaked to parents. Name any parent that aborted solely because a child failed — a candidate for better error handling / isolation.

## Output

- Markdown tables for the depth breakdown; a fenced list for cascade paths.
- Timestamps for the first and last error.
- Cite only errors present in `errorPropagation` and the event stream; never invent failures or causes.
- If the session has no errors, say so plainly and stop.
- If the dashboard is unreachable, tell the user to start it with `npm start` from the repo root.

© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
error-detective VoltAgent Community Субагент error-detective для Claude Code, который разбирает ошибки в распределённых системах: коррелирует сбои между сервисами, ищет корневые причины и предлагает меры, чтобы сбои не повторялись. CX Codex 7 557установок error-diagnostics-smart-debug sickn33 Скилл error-diagnostics-smart-debug разбирает сбои по шагам воспроизведения, трассировкам, логам и коду, затем помогает проверить гипотезу и зафиксировать исправление. CX Codex +1 1установок integration-error-observability Samuel Berthe Скилл integration-error-observability помогает спроектировать показ ошибок внешним разработчикам: логи запросов с повтором, сквозные correlation ID и правила оповещений партнёров. CX Codex +1 10 300установок error-analysis Seth Hobson Команда error-analysis для Claude Code разбирает ошибки — от стектрейса до распределённой трассировки. CX Codex +1 ★ 42 780звёзд репо error-debugging Seth Hobson Плагин error-debugging анализирует ошибки, трассирует исполнение и диагностирует сбои во взаимодействии агентов. Пригодится при поиске причин неполадок в сложных сценариях. CX Codex ★ 42 780звёзд репо instrument-error-tracking PostHog Скилл instrument-error-tracking для Claude Code добавляет сбор исключений в PostHog. Запускается после реализации функции или ревью PR, чтобы настроить отслеживание ошибок. CX Codex +1 546установок

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

Весь набор →
concurrency-report Скилл concurrency-report разбирает параллельное выполнение агентов в сессии: показывает занятость линий, пиковую ширину и последовательные цепочки. Помогает понять, где работа шла параллельно, а где — по очереди. CX Codex +1 ★ 1 198звёзд репо fleet-runs Скилл fleet-runs для Claude Code и Codex, который читает журналы Workflow-флотов из Agent Monitor и показывает статус каждого запуска с разбором по агентам. CX Codex +1 ★ 1 198звёзд репо transcript-replay Скилл transcript-replay для Claude Code пошагово разбирает историю сессии из Agent Monitor, группируя запросы, решения ассистента и вызовы инструментов в краткую сводку. CX Codex +1 ★ 1 198звёзд репо delegation-audit Скилл delegation-audit разбирает, какие модели выполняли задачи субагентов, и оценивает их результативность. Помогает найти неудачные назначения и повторные запуски. CX Codex +1 ★ 1 198звёзд репо issue-triager Субагент issue-triager находит сбои в Claude Code Agent Monitor, проверяет базу данных, хуки и API, а затем выдаёт шаги починке с уровнем критичности. CX Codex ★ 1 198звёзд репо insights-advisor insights-advisor — субагент для Claude Code, который анализирует данные Agent Monitor и ищет связи между сессиями. Он включается для разбора расходов, рабочих процессов и ошибок агентов. CX Codex ★ 1 198звёзд репо focus-analyst Субагент focus-analyst считает метрики фокуса по сессиям Agent Monitor: длину ходов, глубину размышлений, разрывы во времени. На выходе — профиль и 1–3 окна для глубокой работы. CX Codex ★ 1 198звёзд репо i18n-parity Правило i18n-parity требует переносить любые правки интерфейса и документации во все поддерживаемые локали в том же пулреквесте, запрещая сдавать неполные переводы. CX Codex +1 ★ 1 198звёзд репо

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

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