CtrlK
BlogDocsLog inGet started
Tessl Logo

task-breakdown

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).

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong orchestration skill: fully executable commands, a well-sequenced workflow with validation and error recovery at every fragile point, and clear division of labour between model and script. The only costs are minor historical/parenthetical padding and an all-inline layout that forgoes reference-file splitting.

Suggestions

Trim the historical rationale in the Model section to a one-line recommendation ("run on a capable model; /model sonnet for a cheaper run; avoid Haiku") — the removed-pin backstory costs tokens without changing behavior.

Move the fallback manual-authoring path (step 2, ~15 lines of field listings) into a references/fallback.md linked one level deep, keeping the preferred --prepare-tasks flow as the sole inline path.

Tighten the long parentheticals in steps 2–3 (e.g. the overflow mechanics of "Prompt is too long" / output truncation) to their operative clause.

DimensionReasoningScore

Conciseness

The body is dense and operational with no explanations of concepts Claude already knows, but includes trimmable material: the historical rationale for removing the model pin ("a hard `model:` pin ran the inline turn on that model, dragging the whole conversation... overflowed and broke invocation") and several long parentheticals in steps 2–3. Not 5: not every token earns its place; not 3: the excess is minor and localized.

4 / 5

Actionability

Fully executable guidance: exact commands (`python3 <renderer> --prepare-tasks <export.json>`, `--render-tasks <export.json> <grouping.json>`), concrete renderer path resolution for both install layouts, a complete grouping.json schema example, and specific field-by-field fallback instructions. Not 4: there are no gaps — commands are copy-paste ready and the common cases are covered.

5 / 5

Workflow Clarity

Seven clearly sequenced steps with explicit validation: the renderer validates grouping (duplicate/unknown unit ids, schema drift) with warnings surfaced, unassigned units are swept into a warned-about catch-all, a missing-request_units error path instructs the model to stop, and step 7 gives a reporting checklist with an overflow guard. Not 4: validation checkpoints and error-recovery handling are explicit throughout.

5 / 5

Progressive Disclosure

The single SKILL.md is well-sectioned (Inputs, Steps, Guardrails) with the only external reference — the sibling session-metrics renderer script — clearly signaled with two concrete resolution paths. No bundle files exist to verify. Not 5: all content lives inline in one ~165-line file; the fallback authoring path and grouping-signal/verdict detail could be split into one-level-deep reference files. Not 3: structure is good and nothing is buried.

4 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete actions with output artifact names, an explicit trigger clause with natural user phrasings and synonyms, complete what/when coverage, and a well-scoped niche. It is longer than typical examples but every clause carries information — no padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Group a session's turns into higher-level SEMANTIC TASKS", "render a Tasks companion page (*_tasks.html + *_tasks.md)", "worth-it / mixed / likely-waste verdict per task", "Consumes the deterministic per-request breakdown (request_units)" — with comprehensive coverage including output artifacts and argument handling. Not 4: there are no gaps in the action coverage.

5 / 5

Completeness

Explicitly answers both questions: the "what" (group turns into semantic tasks, render a Tasks page with verdicts) and an explicit "Trigger when..." clause with concrete trigger phrases, plus Args documentation. Matches the anchor-5 example structure exactly; not 4 because the 'when' is already fully explicit.

5 / 5

Trigger Term Quality

Covers natural user phrasings comprehensively with synonyms: "group my turns into tasks", "what tasks did this session cover", "which work was worth it vs wasted", "break this session into tasks", plus the explicit /task-breakdown command trigger. Not 4: no common variation of the request is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (task-level analysis of session-metrics JSON exports) with distinct triggers unlikely to fire for unrelated skills. The only related skill is session-metrics itself, and the chaining ("when session-metrics suggests a task breakdown") is intentional and unambiguous. Not 4: no real overlap risk remains.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
centminmod/my-claude-code-setup
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.