CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

parallel-work

Shapes for running many sub-agents at once — fan-out with a barrier, maker/checker, generate-and-filter, tournaments for ranking, hypothesis fan-out for root cause, and loops that stop on a condition with a cap. Use when a phase has several independent targets, when a task is too large or too repetitive for one window, when the same edit applies across many files, when ranking or judging a large set, when several hypotheses compete, or when work must repeat until a signal says stop. Does not apply when units depend on each other's results or the cause is still unknown — investigate first, then parallelize.

Quality

90%

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

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

An exemplary lean orchestration skill: dense, non-obvious guidance with explicit stop conditions, caps, and role separation throughout. The only weaknesses are the absence of an inline example of a unit dispatch and no error-handling path for a failed unit within a fan-out.

Suggestions

Add one short inline example of a unit dispatch prompt and the consolidator's merge step, since the mechanics currently require jumping out to the delegate skill.

State what to do when an individual unit dispatch fails or errors mid-fan-out (e.g., retry once, then mark that unit BLOCKED in the merge report), mirroring the existing PARTIAL/BLOCKED convention for caps.

DimensionReasoningScore

Conciseness

The ~45-line body is dense and operational throughout — "Parallelism buys fresh context per unit and speed. It costs coordination..." — with no padding and no explanation of concepts Claude already knows; every section adds non-obvious guidance (preconditions, caps, maker/checker separation).

5 / 5

Actionability

Guidance is specific and executable — "Set the cap before the first iteration (default 5). At the cap, report PARTIAL with what remains", "Route review to a different agent... with the success criteria and the artifact path", "one dispatch per unchecked item, each told to tick its own line on DONE" — but the actual dispatch mechanics and any example unit/merge prompt are delegated to the pointer files rather than shown inline.

4 / 5

Workflow Clarity

Each shape carries a clear sequence with explicit checkpoints — stop conditions ("no new findings, zero errors in the gate output, no unchecked items remain"), pre-fan-out caps, and PARTIAL/BLOCKED reporting on cap hit; maker/checker and review dispatches validate batch fan-outs. The gap: no stated handling for a unit dispatch that fails or errors mid-fan-out, so error recovery is only partially covered.

4 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections and no inline content that belongs in a separate file; its external references (the delegate SKILL.md and harness-notes) are one level deep and clearly signaled both inline in Preconditions and in a dedicated Pointers section.

5 / 5

Total

18

/

20

Passed

Description

92%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 strong description: concrete shape enumeration, explicit use-when triggers, and a well-drawn negative boundary. The only gap is missing the most colloquial synonyms ("in parallel", "concurrently") that users would naturally say.

Suggestions

Add natural trigger synonyms such as "in parallel", "concurrently", or "speed up" — users asking to parallelize work will say these before naming shapes like "fan-out with a barrier".

DimensionReasoningScore

Specificity

The description enumerates six concrete capability shapes — "fan-out with a barrier, maker/checker, generate-and-filter, tournaments for ranking, hypothesis fan-out for root cause, and loops that stop on a condition with a cap" — giving comprehensive, specific coverage rather than generic claims.

5 / 5

Completeness

It explicitly answers both questions: the opening sentence states what the skill does (orchestration shapes for many sub-agents), the "Use when..." clause gives six concrete triggers, and it adds a negative boundary ("Does not apply when units depend on each other's results or the cause is still unknown").

5 / 5

Trigger Term Quality

Natural trigger phrases are present ("too large or too repetitive for one window", "the same edit applies across many files", "ranking or judging a large set", "root cause"), but the most natural user phrasings for this skill — "in parallel", "concurrently", "speed up" — never appear.

4 / 5

Distinctiveness Conflict Risk

A clear niche (parallel orchestration shapes) with distinct triggers and an explicit exclusion clause that prevents triggering for sequential or investigative work; only minor conceptual overlap with the sibling delegate skill.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 4 suspicious

Warning

Total

15

/

16

Passed

Repository

Jamie-BitFlight/claude_skills

Path

plugins/agent-orchestration/skills/parallel-work/SKILL.md

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.