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

workflow-optimizer — скилл для Claude Code

Анализирует граф оркестрации, цепочки инструментов и расходы моделей через Agent Monitor API. Помогает находить циклы ошибок и лишние траты токенов.

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

Что делает workflow-optimizer

Скилл подключается к API Agent Monitor и запрашивает 11 наборов данных по конкретной сессии через эндпоинт GET /api/workflows/{sessionId}. Он изучает граф вызовов субагентов (DAG), матрицу переходов между инструментами вроде Read и Edit, а также глубину передачи ошибок от дочерних агентов к родительским.

Инструмент сверяет расход токенов и сжатие контекста с правилами ценообразования из GET /api/pricing. Это помогает выявить неэффективное делегирование: например, отправку простых задач в Opus вместо Haiku или Sonnet. На выходе формируется таблица из 5 ключевых рекомендаций с оценкой потенциальной экономии и трудозатрат на внедрение.

Без запущенного сервера Agent Monitor скиллу неоткуда брать метрики сессий.

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

  • Найти зацикливания и повторные вызовы одних и тех же инструментов
  • Выявить сбои субагентов по уровням вложенности дерева задач
  • Снизить расходы за счёт перераспределения задач на дешёвые модели
  • Обнаружить сессии с частым сжатием контекста и нехваткой токенов

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

  • Запусти workflow-optimizer для анализа сессии session_12345 с фокусом на cost
  • Проанализируй цепочки инструментов с помощью workflow-optimizer tools
  • Выполни workflow-optimizer analyze для поиска узких мест в параллельных агентах

Как установить workflow-optimizer

1Через Skills CLI (Vercel)

npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill workflow-optimizer -a claude-code

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

~/.claude/skills/workflow-optimizer/SKILL.md

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

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

Вопросы о workflow-optimizer

Как установить workflow-optimizer в Claude Code?

Выполните команду npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill workflow-optimizer -a claude-code. Также можно поместить файл вручную по пути ~/.claude/skills/workflow-optimizer/SKILL.md.

Какие данные нужны для работы workflow-optimizer?

Скилл обращается к API Agent Monitor и запрашивает сессии через GET /api/sessions, аналитику через GET /api/analytics, цены через GET /api/pricing и 11 наборов данных через GET /api/workflows/{sessionId}.

Что даёт запуск с фокусом errors?

Режим errors концентрируется на анализе errorPropagation. Он показывает, на какой глубине дерева субагентов возникают сбои и как они распространяются наверх.

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

SKILL.md · MIT
---
name: workflow-optimizer
description: >
  Analyze workflow patterns using the Agent Monitor's workflow intelligence
  API — orchestration DAGs, tool flow transitions, subagent effectiveness,
  model delegation patterns, error propagation by depth, concurrency lanes,
  compaction impact, and agent co-occurrence. Produces prioritized optimization
  recommendations with quantified impact.
---

# Workflow Optimizer

Analyze Claude Code workflows using the Agent Monitor's workflow intelligence engine.

## Input

The user provides: **$ARGUMENTS**

Options: "analyze", a session ID for single-session analysis, or a focus: "tools", "subagents", "cost", "errors".

## Data Sources

| Endpoint | Returns |
|----------|---------|
| `GET /api/sessions?limit=100` | Session list with metadata |
| `GET /api/workflows/{sessionId}` | **11 workflow datasets** (see below) |
| `GET /api/analytics` | Tool usage top 20, event types, agent types |
| `GET /api/pricing` | Model pricing rules for cost comparison |

### Workflow Intelligence API (`GET /api/workflows/{sessionId}`)

Returns these 11 datasets per session:

| Dataset | Content |
|---------|---------|
| `stats` | Aggregate session stats: tool count, agent depth, event count |
| `orchestration` | **DAG**: agent nodes with parent/child edges, depths, types |
| `toolFlow` | **Transition matrix**: tool A → tool B with counts (common sequences) |
| `effectiveness` | **Subagent success**: per-type completion rates, avg duration, task success |
| `patterns` | **Recurring sequences**: detected workflow patterns with frequency |
| `modelDelegation` | **Model choices**: which models are delegated which tasks |
| `errorPropagation` | **Error flow by depth**: where in the agent tree errors originate and propagate |
| `concurrency` | **Concurrency lanes**: overlapping agent execution timelines |
| `complexity` | **Complexity score**: numerical score based on depth, breadth, tool diversity |
| `compaction` | **Compaction impact**: token savings, frequency, context health |
| `cooccurrence` | **Agent pairs**: which agents frequently run together |

## Optimization Analyses

### 1. Tool Flow Optimization
From `toolFlow` transition data:
- Identify the most common tool sequences (e.g., Read → Edit → Bash)
- Find redundant transitions (same tool called repeatedly = retries)
- Detect anti-patterns: high-frequency failure loops
- Recommend tool chain shortcuts

### 2. Subagent Strategy
From `effectiveness` + `orchestration`:
- Which subagent types (task, explore, code-review) have highest completion rates
- Average duration per subagent type — are subagents taking too long?
- Underutilized types: tasks that could benefit from delegation
- Over-spawning: too many subagents for simple tasks

### 3. Model Delegation Analysis
From `modelDelegation`:
- Which models handle which task types
- Cost-per-task comparison across models
- Opportunities to delegate simple tasks to cheaper models (Haiku/Sonnet instead of Opus)
- Calculate estimated savings from model rebalancing

### 4. Error Prevention
From `errorPropagation`:
- Where errors originate (agent depth level)
- How errors cascade to parent agents
- Error types (APIError, tool failure) by frequency
- Defensive strategies: which patterns lead to fewer errors

### 5. Concurrency Optimization
From `concurrency`:
- Which agents run in parallel vs sequential
- Bottlenecks: sequential agents that could be parallelized
- Resource contention: overlapping heavy tasks

### 6. Context Health
From `compaction`:
- How often compaction occurs per session
- Token recovery from compaction baselines
- Sessions that hit context limits — suggest breaking into smaller tasks

## Output

Prioritized recommendations table:

| # | Recommendation | Source Data | Impact | Effort | Est. Savings |
|---|---------------|-------------|--------|--------|-------------|

Top 5 recommendations with detailed explanation, supporting data from the workflow API, and implementation steps.

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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. 1 052 851установок ask-matt Matt Pocock Помогает выбрать подходящий скилл или рабочий поток из набора Matt Pocock. Пригодится, когда непонятно, с чего начать задачу: от идеи до разбора бага. 766 587установок to-tickets Matt Pocock Разбивает план, спецификацию или переписку на небольшие сквозные задачи и отмечает, какие из них блокируют остальные. Пригодится, когда нужно согласовать порядок работы до публикации задач в трекере. 711 230установок writing-plans Jesse Vincent Скилл превращает требования к многошаговой задаче в подробный план реализации до начала работы с кодом. Пригодится, когда исполнителю нужно зафиксировать файлы, интерфейсы и проверки. CX Codex 282 859установок caveman-review JuliusBrussee Пишет замечания к коду одной строкой: место, проблема, исправление. Пригодится, когда ревью диффа или PR надо пройти быстро и без воды. CX Codex +1 411 800установок caveman-compress JuliusBrussee Сжимает CLAUDE.md, списки задач и другие текстовые файлы в краткий формат, сохраняя читаемую резервную копию. CX Codex +1 411 500установок

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

regression-alert Сравнивает надёжность агента за текущий период с прошлым и показывает, где стало хуже. Полезен, когда нужно понять, деградировала ли работа. CX Codex +1 ★ 1 121звёзд репо hook-failure-audit Оценивает надёжность передачи хуков по данным Agent Monitor: находит зависшие вызовы инструментов, незакрытые сессии и остановку сбора событий. CX Codex +1 ★ 1 121звёзд репо error-scan Сканирует недавние сессии Claude Code и группирует ошибки по инструментам и моделям. Пригодится, когда нужно понять, что сейчас ломается. CX Codex +1 ★ 1 121звёзд репо api-error-report Разбирает события APIError из Agent Monitor: сколько их, в каких сессиях и моделях, и что скорее всего стало причиной. CX Codex +1 ★ 1 121звёзд репо weekly-report Собирает недельный отчёт по сессиям Agent Monitor: затраты, токены, инструменты, завершённые задачи и динамика по дням. Пригодится для разбора работы за выбранную неделю. CX Codex +1 ★ 1 121звёзд репо time-of-day Разбирает сессии и события по часам суток и дням недели, показывает пики активности и провалы. Пригодится, когда планируете график глубокой работы. CX Codex +1 ★ 1 121звёзд репо sprint-summary Составляет отчёт по спринту на основе метрик Claude Code Agent Monitor: группирует сессии по проектам, считает расходы на модели и скорость работы. CX Codex +1 ★ 1 121звёзд репо monthly-review Собирает месячную сводку по данным Agent Monitor: расходам, сессиям, токенам и проектам. Пригодится для ретроспективы и планирования следующего месяца. CX Codex +1 ★ 1 121звёзд репо

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

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