CtrlK
BlogDocsLog inGet started
Tessl Logo

flow-parallel

Decompose and execute large changes, migrations, or multi-issue fixes in parallel with quality gates

54

Quality

61%

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 ./.claude/skills/flow-parallel/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

The body is an exceptionally actionable, rigorously gated workflow — complete executable scripts, hard validation barriers between steps, and thorough error handling for a batch operation. Its weaknesses are verbosity (redundant enforcement language and a Prohibitions section that restates the per-step rules) and a complete absence of progressive disclosure: a ~800-line monolith whose script templates should live in bundle files.

Suggestions

Cut the redundant enforcement padding: each step already ends with a 'DO NOT PROCEED' gate, so the 11-item Prohibitions section, the 'STOP - SKILL ALREADY LOADED' header, and the repeated 'MANDATORY - CANNOT SKIP' bolding restate the same constraints two to three times.

Move the stable artifacts — the launch.sh template, the dependency-validation Python script, and the instructions.md template — into scripts/ and reference/ files in the bundle, keeping SKILL.md as an overview with one-level-deep pointers.

Remove version annotations (v8.44.0, v8.32.0, v8.45.0) from the body, or collect them in a changelog/old-patterns section; they are time-sensitive noise for the executing model.

DimensionReasoningScore

Conciseness

The body is noticeably verbose: it does not explain concepts Claude already knows, but it pads heavily with repeated enforcement shouting ('MANDATORY', 'CANNOT SKIP', 'DO NOT PROCEED TO STEP X' repeated after every step, an 11-item Prohibitions section that restates per-step rules verbatim, and a 'STOP - SKILL ALREADY LOADED' header), plus version-number annotations ('v8.44.0', 'v8.32.0', 'v8.45.0') that are time-sensitive and irrelevant to executing the skill. This fits the 'noticeably verbose; several unnecessary explanations or padded sections' anchor. It is not a 1 because the bulk of the content is genuinely load-bearing executable script rather than filler, and not a 3 because the repetition of gating language and the redundant Prohibitions section could be cut substantially with no loss of clarity.

2 / 5

Actionability

Every step ships complete, copy-paste-ready bash and Python: the provider check command, the WBS heredoc template with a JSON validation snippet, a full cycle-detecting dependency validator, the instructions.md/launch.sh templates with worktree fallback handling, the complete wave-based launch/monitor loop, and the aggregation script. Placeholders are present but their substitution is explicitly mandated with instructions ('You MUST replace <absolute-project-root-path>... use pwd'), which the rubric treats as justified flexibility. It is not a 4 because there are no pseudocode blocks or missing key details anywhere in the workflow.

5 / 5

Workflow Clarity

A strict 7-step sequence with an explicit validation gate after each step (wbs_generated, instructions_written, processes_launched, all_work_packages_complete), hard 'DO NOT PROCEED' barriers, an adversarial cross-check of the WBS before launch, dependency validation with cycle detection that stops on failure, a monitoring loop with timeout and progress reporting, and a dedicated Error Handling section covering failed WPs, timeouts, and missing claude CLI. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery' exactly — and since this is a batch operation, the presence of full validation is what keeps it above the batch-cap of 3.

5 / 5

Progressive Disclosure

The skill has no bundle at all — no references/, scripts/, or assets/ — so everything lives inline in a single ~800-line SKILL.md with good section headers. That fits 'some structure but could be better organized': the launch.sh template, the dependency-validation Python program, and the instruction template are self-contained artifacts that clearly belong in scripts/ files and would be referenced one level deep instead of inlined. It is not a 4 because this inlining is substantial rather than a minor gap, and not a 2 because the file is well-sectioned, easy to navigate, and contains no nested or buried references.

3 / 5

Total

15

/

20

Passed

Description

53%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.

The description gives a clear, moderately specific 'what' with a recognizable domain and natural keywords, but it omits any explicit 'use when' trigger guidance and underuses the natural alias terms (batch, team, parallel) that the skill itself defines. It reads as a competent one-line summary that would benefit most from an explicit trigger clause.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to parallelize a large change, run a batch migration, or fix multiple issues at once.'

Include the natural synonyms users would say (batch, team, parallelize, worktrees) since they are already declared as aliases in the frontmatter but absent from the description.

Name one more concrete action (e.g., 'aggregate and quality-check results') to round out the capability list currently carried by the vague phrase 'quality gates'.

DimensionReasoningScore

Specificity

The description names its domain ('large changes, migrations, or multi-issue fixes') and two concrete actions ('Decompose and execute... in parallel'), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is not a 4 because 'quality gates' is abstract and no further concrete actions (e.g., aggregate results, launch agents) are listed; it is above a 2 because the actions and domain are real rather than generic.

3 / 5

Completeness

The 'what' is clear ('Decompose and execute large changes, migrations, or multi-issue fixes in parallel with quality gates'), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It scores a full 3 rather than 2 because the 'what' is concrete and specific, and not 4 because the 'when' is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

Terms like 'migrations', 'multi-issue fixes', and 'parallel' are words a user might naturally say, but the description misses common variations users would actually type such as 'batch', 'team', 'in parallel', or 'worktrees' — several of which the skill itself declares as aliases. This fits 'some relevant keywords but missing common variations or synonyms'; it is not a 4 because the natural-phrase coverage is thin, and not a 2 because the keywords present are user-natural rather than technical jargon.

3 / 5

Distinctiveness Conflict Risk

Parallel decomposition of compound tasks into isolated work packages with quality gates is a fairly distinct niche with little overlap risk against typical single-task skills. It is not a 5 because the description does not name distinct triggers, so a generic 'make this big change' request could plausibly route to other migration or refactoring skills; it is above a 3 because the core capability described is not something common skills claim.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (809 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
nyldn/claude-octopus
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.