CtrlK
BlogDocsLog inGet started
Tessl Logo

task-breakdown

Use when a feature touches 4 or more files, involves multiple components, or has subtasks that could run in parallel.

58

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/claude-code/skills/task-breakdown/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

The body is a tightly structured, highly actionable workflow with concrete JSON templates and an explicit validation step. Its only weakness is mild redundancy from the motivational Red Flags/Rationalizations sections that restate existing rules.

Suggestions

Trim or collapse the 'Red Flags' and 'Common Rationalizations' sections, which restate rules already covered in 'Remember' and the step rules.

Merge the 'Remember' bullet list with the inline per-step rules to avoid duplicating the context_files/reference_files and binary-criteria guidance.

DimensionReasoningScore

Conciseness

The core process is lean with concrete JSON templates, but the 'Red Flags', 'Common Rationalizations' table, and 'Remember' section restate rules already given, adding padding that could be tightened — matching 'mostly efficient but includes some unnecessary explanation'.

2 / 3

Actionability

It provides complete, executable JSON templates with exact file paths (`.tmp/tasks/{feature}/subtask_01.json`), explicit field rules, and a copy-paste summary format, matching 'fully executable code/commands; specific examples; copy-paste ready'.

3 / 3

Workflow Clarity

A clear five-step sequence (Analyze → Plan → Generate → Validate → Return) includes an explicit validation checkpoint (Step 4's ✅ checklist) and error-recovery framing via Red Flags, matching 'clear sequence with explicit validation steps; feedback loops'.

3 / 3

Progressive Disclosure

There are no bundle files (references/scripts/assets absent); the ~150-line body is self-contained with well-labeled sections and no nested references, so under the simple-skill scoring note the organization alone merits a 3.

3 / 3

Total

11

/

12

Passed

Description

50%

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

The description leads with an explicit, reasonably specific 'Use when' trigger but omits any statement of what the skill actually does, leaving the capability unstated. It is clear enough to activate but under-claims its function.

Suggestions

Open with the capability before the trigger, e.g. 'Breaks down complex features into atomic, verifiable subtasks with dependency tracking.'

Add natural trigger terms a user would say, such as 'feature', 'subtasks', or 'execution plan', alongside the structural conditions.

State the deliverable (a task.json + subtask JSON files) so the 'what' is explicit, not just the 'when'.

DimensionReasoningScore

Specificity

The description names a domain (features touching files / components / parallel subtasks) but states no concrete actions — 'touches 4 or more files' and 'has subtasks' are conditions, not capabilities, matching the 'names domain and some actions, but not comprehensive' anchor.

2 / 3

Completeness

The 'when' is explicitly and strongly answered, but the 'what' is never stated — the description does not say the skill breaks features into subtasks, so it sits at 'has what, but when is missing or only implied' inverted (strong when, weak what).

2 / 3

Trigger Term Quality

It opens with an explicit 'Use when' clause and surfaces structural triggers like '4 or more files' and 'run in parallel', but lacks natural user-facing keyword variations, fitting 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

The quantitative '4 or more files' trigger is fairly specific and reduces conflict, yet 'multiple components' is generic enough to overlap with general planning skills, matching 'somewhat specific but could still overlap'.

2 / 3

Total

8

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
darrenhinde/OpenAgentsControl
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.