CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-parallel-agents

Decompose large tasks across parallel agents — use for migrations, multi-file refactors, or batch work

55

Quality

63%

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

Quality

Content

56%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 content is highly actionable with well-sequenced phases, validation gates, and copy-paste commands, but it is a monolithic 650-line document that buries its reference material inline instead of splitting it into bundle files. Verbosity (repeated command listings, ASCII art, compliance threats, cost/marketing tables) and a dangling file reference are the main quality costs.

Suggestions

Move the Command Reference, Agent Selection, Provider-Aware Routing, and providers-config example into reference files (e.g., references/commands.md, references/providers.md) and keep SKILL.md to Quick Start, phase overview, and routing rules — this fixes both conciseness and progressive disclosure.

Cut duplicated orchestrate.sh invocations (Quick Start vs. per-phase sections vs. Example Workflows) to one canonical set, and remove the ASCII art and repeated MANDATORY COMPLIANCE bullets in favor of a two-line imperative.

Fix or remove the dangling `skills/blocks/codex-host-adapter.md` reference, and add an explicit fix-and-revalidate loop for FAILED tangle quality gates instead of 'Ink phase flags for review'.

DimensionReasoningScore

Conciseness

The body is ~650 lines with several padded sections: two large ASCII diagrams, a "MANDATORY COMPLIANCE" section that repeats the same prohibition four ways, the same orchestrate.sh invocations re-listed in Quick Start and again per-phase, a cost table with dollar estimates, and provider subscription-tier tables — much of this is not knowledge Claude lacks. It is not a 1 because it never explains basic external concepts (e.g., what a CLI is) and most sections do carry operational content.

2 / 5

Actionability

Commands are concrete and copy-paste ready throughout — full invocations like `orchestrate.sh probe "..."` with realistic prompts, a prerequisites check with exact expected output and status values, a routing table, and per-option defaults. Not 5 because several commands reference behavior that is only named, not specified (what `spawn <agent>` does, how `--context` glob patterns resolve), and outputs like `probe-synthesis-*.md` are shown without how to consume them.

4 / 5

Workflow Clarity

The Double Diamond sequence is clearly ordered with explicit context chaining (`--context grasp-consensus-*.md`), validation checkpoints exist (preflight, detect-providers with status-based routing, tangle quality gates at 90/75% thresholds), and Troubleshooting covers failure recovery. Not 5 because the failure loop is only loosely closed — a FAILED gate just means "Ink phase flags for review" with no explicit fix-and-revalidate step in the workflow itself, and the batch-parallel dispatch path has no verification of sub-agent results.

4 / 5

Progressive Disclosure

Section structure is real and consistent (Quick Start, phases, Command Reference, Troubleshooting), so it is above the 'minimal structure' anchor. But roughly 300 lines of command reference, agent tables, and provider config examples are inlined that clearly belong in separate reference files, no bundle files exist at all, and the one body reference — `skills/blocks/codex-host-adapter.md` — does not resolve to a real file in this bundle.

3 / 5

Total

13

/

20

Passed

Description

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

A well-formed, concise description with an explicit 'use for' trigger clause and natural keywords. Its main weakness is underselling the skill: it describes generic parallel-task decomposition while the body is a multi-provider orchestration system, which both thins the 'what' and raises overlap risk with generic parallel-agent skills.

Suggestions

Enumerate 2-3 more concrete capabilities in the 'what' half (e.g., '...via a four-phase Double Diamond workflow with adversarial cross-model review and quality gates') so the description matches the skill's actual scope and lifts specificity.

Add one distinctive trigger term such as 'multi-provider' or 'cross-model review' to reduce conflict risk with generic subagent-delegation skills.

DimensionReasoningScore

Specificity

The description names the domain ("parallel agents") and one concrete action ("Decompose large tasks"), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not reach 4 because no further specific actions (e.g., fan-out, map-reduce, adversarial review, quality gates) are listed, even though the skill body contains many.

3 / 5

Completeness

Both 'what' ("Decompose large tasks across parallel agents") and 'when' ("use for migrations, multi-file refactors, or batch work") are explicitly present, so it clears the score-3 cap for a missing when-clause. Not 5 because the 'what' is thin relative to the skill's actual scope — it omits the Double Diamond workflow, adversarial cross-model review, and auto-routing that dominate the body — leaving the when-clause without a fully concrete counterpart.

4 / 5

Trigger Term Quality

"use for migrations, multi-file refactors, or batch work" provides good natural keyword coverage that users would plausibly say. Not 5 because common synonyms and phrasings users actually use for this skill's core behavior ("parallelize", "fan out", "run tasks concurrently", "multi-provider", "orchestrate") are missing.

4 / 5

Distinctiveness Conflict Risk

The trigger list (migrations, multi-file refactors, batch work) is concrete and gives it a recognizable niche with mostly distinct triggers. Not 5 because "Decompose large tasks across parallel agents" is a crowded capability that overlaps generic subagent-delegation and orchestrator skills, and the description gives no distinguishing signal (multi-provider, Double Diamond, adversarial review) that would separate it from those.

4 / 5

Total

15

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

15

/

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.