error-propagation — скилл для Claude Code: что делает и как установить
Скилл error-propagation находит, на какой глубине мультиагентной сессии возникла ошибка и как она докатилась до родительских агентов.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-workflows@claude-code-agent-monitor-pluginsЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/error-propagation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/error-propagation/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill error-propagation -a codex2Вручную: положить файлы
.agents/skills/error-propagation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill error-propagation -a cursor2Вручную: положить файлы
.cursor/skills/error-propagation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor plugins/ccam-workflows/skills/error-propagation2Вручную: положить файлы
.github/skills/error-propagation/SKILL.md1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill error-propagation -a gemini-cli2Командой платформы
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path plugins/ccam-workflows/skills/error-propagationВручную: положить файлы
.devin/skills/error-propagation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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