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

task-breakdown · centminmod — скилл для Claude Code: что делает и как установить

Скилл task-breakdown группирует запросы из сессии Claude Code в осмысленные задачи и оценивает их пользу по метрикам.

MIT ★ 2 744 обновлён 2026-10-08

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

Что делает task-breakdown

Скилл берёт детальный экспорт session-metrics с массивом request_units и объединяет отдельные шаги диалога в понятные задачи вроде настройки авторизации или отладки кеша. Сами токены, стоимость и время скилл заново не считает: все цифры берутся строго из входного файла.

Модель отвечает только за смысловую кластеризацию и вердикты (worth_it, mixed, likely_waste). Скрипт session-metrics.py запускается с флагом --prepare-tasks, строит предварительный скелет задач и генерирует итоговый отчёт в форматах HTML и Markdown.

Без готового экспорта session-metrics запустить разбор не выйдет, а слабая модель вроде Haiku не справится с оценкой контекста. Автор советует запускать скилл на Sonnet или текущей рабочей модели.

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

  • разбить длинную сессию на смысловые блоки
  • найти неэффективные траты токенов и времени
  • сформировать отчёт по выполненным задачам в HTML и Markdown
  • оценить практическую пользу каждого шага в диалоге

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

  • /task-breakdown exports/session-metrics/session_12345678.json
  • Сгруппируй шаги этой сессии в задачи и покажи отчёт
  • Какие задачи решались в сессии и что из этого было пустой тратой?

Как установить task-breakdown

1Через Skills CLI (Vercel)

npx skills add centminmod/my-claude-code-setup --skill task-breakdown -a claude-code

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

~/.claude/skills/task-breakdown/SKILL.md

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

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

Вопросы о task-breakdown

Как установить task-breakdown в Claude Code?

Выполните команду npx skills add centminmod/my-claude-code-setup --skill task-breakdown -a claude-code. Также можно скопировать файл в ~/.claude/skills/task-breakdown/SKILL.md.

Что делает скилл task-breakdown?

Он анализирует лог обращений из session-metrics, объединяет запросы по целям и выставляет каждому блоку вердикт полезности. На выходе создаются файлы *_tasks.html и *_tasks.md.

Какие требования нужны для работы скилла?

Необходим скрипт session-metrics.py и JSON-экспорт с массивом request_units. Без предварительного экспорта метрик скилл работать не сможет.

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

SKILL.md · MIT
---
name: task-breakdown
description: >
  Group a session-metrics session's turns into higher-level SEMANTIC TASKS
  ("what was I actually trying to do") and render a Tasks companion page
  (*_tasks.html + *_tasks.md) with a worth-it / mixed / likely-waste verdict
  per task. Trigger when the user runs /task-breakdown, when session-metrics
  suggests a task breakdown after a JSON export, or when the user asks to
  "group my turns into tasks", "what tasks did this session cover", "which
  work was worth it vs wasted", or "break this session into tasks". Consumes
  the deterministic per-request breakdown (request_units) from a
  session-metrics JSON export — it never re-derives cost or token numbers.
  Args: $ARGUMENTS[0] = path to a session-metrics JSON export (optional;
  if omitted, generate one first).
---

# Task Breakdown

Turns a session's **per-request breakdown** (the deterministic `request_units`
emitted by session-metrics) into **semantic tasks** the user actually thinks
in — "added auth", "debugged the cache miss" — and labels each with a verdict.
You do the one thing deterministic code can't: decide which requests belong to
the same task. The script does everything else (cost, turns, tokens, waste
signals, the themed page).

**Model.** This skill runs on your session's current model. It no longer pins
one (a hard `model:` pin ran the inline turn on that model, dragging the whole
conversation into that model's context window — on a long session that
overflowed and broke invocation). The grouping + verdict work is
judgement-heavy, so it wants a capable model; for a cheaper run that's still
strong enough, `/model sonnet` before invoking. Don't drop to Haiku — the
semantic verdicts need the headroom.

**Division of labour — do not blur it:**
- **The export owns the numbers.** Every cost / turn / token / waste figure
  comes from `request_units` in the JSON export. You MUST NOT sum money or
  invent figures — `--render-tasks` recomputes all totals from the export.
- **You own the grouping + labels only.** You assign each `request_unit_id` to
  a task, write a short title, a verdict, and a one-line rationale.

## Inputs

`$ARGUMENTS[0]` (optional) = path to a session-metrics JSON export, e.g.
`exports/session-metrics/session_<id8>_<ts>.json` (session scope is the primary
target; `project_*.json` also works — units carry a `session_id`). The export
must contain a `request_units` array.

If `$ARGUMENTS[0]` is missing, first generate a session export by invoking the
**session-metrics** skill (or run its script) for the session of interest with
`--output json html`, then use the written `session_*.json` path.

## Steps

1. **Locate the export and the renderer.**
   - Export: `$ARGUMENTS[0]`, or the JSON you just generated.
   - Renderer: the sibling **session-metrics** skill's script. Resolve its
     path (it ships in the same plugin):
     - plugin install: `../session-metrics/scripts/session-metrics.py`
     - dev repo: `.claude/skills/session-metrics/scripts/session-metrics.py`
     Use whichever exists (glob if unsure).

2. **Prepare the worksheet + skeleton (preferred — you are an editor, not an
   author).** Run `--prepare-tasks` on the export: it prints a compact
   one-line-per-request worksheet to stdout and writes a *renderable* candidate
   `<stem>_grouping.json` next to the export, with deterministic clustering,
   seeded titles, and suggested verdicts already filled in.

   ```
   python3 <renderer> --prepare-tasks <export.json>
   ```

   The worksheet is your single source of grouping signals — **do not re-probe
   the JSON with `jq`/`Read`.** Each row shows the unit's candidate cluster
   (`cl`), turns, cost, tokens, `risk/reread/cbreak`, idle gap, snippet, and top
   tools; `[cont]` marks an agent-completion continuation and `[blank]` a
   no-prompt unit (both pre-attached to the preceding cluster). On a **large
   session (>120 request units)** the worksheet prints a bounded per-*cluster*
   summary instead of per-unit rows (so stdout never overflows the prompt) — the
   written skeleton still covers every unit, so treat it as your authoritative
   surface and edit it (merge/split/rename) rather than reconstructing the full
   per-unit list inline. Then **edit** the skeleton per steps 3–5 below rather
   than writing it from scratch:
   rename each seeded title (and drop its `_auto_title` field once named),
   merge/split clusters where the worksheet warrants, write one-line rationales,
   and fill any blank verdict the skeleton left for your judgment. Skip to
   step 6 (render) when done.

   *(Fallback — manual authoring.)* If you are not using `--prepare-tasks`, load
   the export JSON and read `request_units` directly. Each unit has: `unit_id`
   (`"<session_id>:<anchor_index>"`), `prompt_snippet`, `prompt_text`,
   `turn_count`, `combined_cost_usd`, `total_tokens`, `tool_histogram`,
   `risk_turn_count`, `reread_path_count`, `cache_break_count`,
   `wall_clock_seconds`, `idle_gap_before_seconds`, `slash_command`,
   `spawned_subagents`, `workflow_run_ids`, `multi_intent_possible`.
   **If `request_units` is absent**, tell the user to re-run session-metrics to
   regenerate the export (the per-request breakdown is a newer feature) and stop.

3. **Group into semantic tasks.** Read the units in order and cluster
   consecutive requests that pursue the same goal into one task. Signals, in
   priority order:
   - **Topical/lexical continuity** of `prompt_snippet`/`prompt_text` (same
     feature, file, bug, or subject) — the PRIMARY signal.
   - **Shared `tool_histogram` / file targets** across adjacent requests.
   - **Slash command / skill** starts (`slash_command`, a `/debug`,
     `/feature-dev`, etc.) often begin a task.
   - **Idle gaps** (`idle_gap_before_seconds`) — a WEAK, confirming-only hint.
     A long gap supports a split you already suspect topically; never split on
     a gap alone (lunch breaks, overnight continuations).
   - A unit flagged `multi_intent_possible` may belong to two tasks — note it,
     but keep the unit whole (it cannot be divided).
   Most sessions yield a handful of tasks. Don't over-segment ("now fix the
   test" is usually the SAME task as the feature it follows), and don't
   under-segment (one giant "misc" task is useless).
   **At large scale** (many dozens of units, e.g. a project-scope export):
   group at **session granularity** — one titled task per coherent
   session-goal — rather than attempting per-unit segmentation. **Never emit a
   single untitled catch-all task that swallows everything**: the renderer's
   collapse guard flags a blank-titled task covering the bulk of requests, and
   it is a useless grouping anyway. If you cannot segment meaningfully, that is
   a signal the input is too coarse for this skill (prefer a single-session
   export).

4. **Label each task with a verdict**, using the deterministic waste signals as
   evidence, NOT a guess:
   - `worth_it` — the task reached its goal at reasonable cost; low
     `risk_turn_count` / re-read churn relative to its size.
   - `likely_waste` — high `risk_turn_count`, repeated `reread_path_count`,
     many `cache_break_count`, or a long turn/cost run with little to show
     (e.g. a debug loop that churned).
   - `mixed` — partly productive, partly churn, or you're unsure.
   **Bias toward `mixed`/`worth_it` when uncertain** — a wrong `likely_waste`
   damages trust more than a missed one. Keep the `rationale` to one honest
   sentence tied to the signals ("12 turns, 4 risky re-reads of the same file
   before the fix landed").

5. **Write `grouping.json`** next to the export (same directory), shape:
   ```json
   {
     "schema_version": "1",
     "scope_label": "session <id8> · <first_ts>",
     "tasks": [
       {
         "title": "Add token-refresh to auth",
         "verdict": "worth_it",
         "rationale": "8 requests, one short debug detour, shipped.",
         "request_unit_ids": ["<sid>:2", "<sid>:3", "<sid>:5"]
       }
     ]
   }
   ```
   Cover **every** `unit_id` exactly once across all tasks. (Any you leave out
   are swept into a synthetic "Ungrouped requests" task automatically, and the
   renderer warns — aim for full coverage.)

6. **Render the companion:**
   ```
   python3 <renderer> --render-tasks <export.json> <grouping.json>
   ```
   The script validates the grouping (flags duplicate / unknown unit ids,
   schema drift), recomputes every total from the export, and writes
   `<stem>_tasks.html` + `<stem>_tasks.md` next to the export. It prints the
   output paths and any validation warnings.

7. **Report back** to the user with a SHORT SUMMARY ONLY — do **not** paste the
   full task list or the rendered `*_tasks.md` inline (on a large session that
   overflows the reply with "Prompt is too long" / output truncation). Include:
   a one-line result (N tasks, total cost, coverage %), the verdict counts
   (worth_it / mixed / likely_waste), any grouping warnings the script surfaced,
   and the `*_tasks.html` / `*_tasks.md` paths. Read every figure back from the
   script's stdout / the rendered `*_tasks.md` — never recompute. Optionally name
   up to **3** notable tasks; the full per-task detail lives in the written
   files. Offer to open the HTML page.

## Guardrails

- **Never invent or sum numbers.** If you need a total, read it from the export
  or from the rendered `*_tasks.md` after `--render-tasks` runs.
- **Don't touch the workflow companion** (`*_workflows.*`) — the Tasks page is
  a separate, additional artifact.
- **Honest framing:** the deterministic dashboard section is "per-request
  breakdown"; only this skill's output is allowed to call groups "tasks",
  because only here did a human-level judgement decide the boundaries.

© centminmod · MIT · centminmod/my-claude-code-setup

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — task-breakdown от других авторов.

task-breakdown jwynia Скилл task-breakdown для Claude Code разбивает перегружающие задачи на выполнимые шаги. Он включается, когда сложно начать, выбрать первый шаг или справиться с когнитивной перегрузкой. CX Codex +1 507установок task-breakdown davidkiss Скилл task-breakdown разбивает сложные технические требования на пошаговый план работ с проверками через TDD перед началом кодинга. CX Codex +1 212установок Task Breakdown Specialist daffy0208 Скилл Task Breakdown Specialist делит крупные задачи разработки на двухминутные и пятнадцатиминутные шаги с поправкой на потерю фокуса, помогая начать проект без ступора. CX Codex +1 149установок planning-and-task-breakdown addyosmani Скилл planning-and-task-breakdown разбивает спецификацию на небольшие проверяемые задачи с явными критериями приемки. Помогает агенту спланировать архитектуру до написания кода и избежать путаницы. CX Codex +1 80 700установок metrics-dashboard phuryn Скилл metrics-dashboard для Claude Code проектирует дашборд метрик с North Star, input-, health- и бизнес-метриками. Помогает определить KPI, настроить product analytics и план мониторинга данных. CX Codex +1 3 200установок analytics OrchestKit Скилл analytics собирает локальную аналитику вызовов агентов, хуков и токенов из файлов Claude Code. Запускается при проверке расходов и производительности сессий. CX Codex +1 210установок skill-logger curiositech Скилл skill-logger для Claude Code, Codex, Cursor и других платформ: фиксирует каждый запуск скилла, считает метрики качества и собирает сигналы для улучшений. CX Codex +1 197установок developer-community-health Samuel Berthe Скилл developer-community-health для Claude Code измеряет здоровье разработческого сообщества: активность, отклик, воронку контрибьюторов и настроения. Выясняет, почему в чате тихо. CX Codex +1 13 300установок

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

Весь набор →
ux-design-expert Субагент ux-design-expert для Claude Code разбирает пользовательские сценарии, собирает дизайн-систему на Tailwind и настраивает графики Highcharts. Разбирает путаницу пользователей в готовом интерфейсе. CX Codex ★ 2 744звёзд репо code-searcher Субагент code-searcher ищет функции, классы и уязвимости в кодовой базе и возвращает ссылки на строки файл:номер. CX Codex ★ 2 744звёзд репо cleanup-context Команда cleanup-context для Claude Code анализирует и сокращает объём файлов документации проекта, удаляя дубли, устаревшие материалы и консолидируя перекрывающийся контент. CX Codex +1 ★ 2 744звёзд репо audit-session-metrics Читает JSON-экспорт session-metrics и выдаёт отчёт о нерациональном расходе токенов. Запускается командой /audit-session-metrics quick или detailed над готовым файлом экспорта. CX Codex +1 ★ 2 744звёзд репо apply-thinking-to Команда apply-thinking-to для Claude Code преобразует файл промпта по схемам расширенного мышления Anthropic. Помогает анализировать задачи, проверять выводы и разбирать компромиссы. CX Codex +1 ★ 2 744звёзд репо create-release-note Команда create-release-note для автоматического создания двух версий документации релиза: покупательской и технической. Анализирует коммиты за последнее время и структурирует изменения по темам. CX Codex +1 ★ 2 744звёзд репо consult-zai Скилл consult-zai запускает параллельный анализ кода двумя моделями: z.ai GLM 5.2 и Claude code-searcher. Помогает получить второе мнение при поиске багов. CX Codex +1 ★ 2 744звёзд репо consult-codex Скилл consult-codex для Claude Code передаёт вопрос о коде OpenAI Codex и Claude code-searcher и сопоставляет их выводы с цитатами на файлы и строки. Помогает при сложной отладке и ревью. CX Codex +1 ★ 2 744звёзд репо

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

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