CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

parallel-agent-spawner

Spawn and coordinate parallel agents for faster completion. Use when running parallel tasks, spawning subagents, coordinating concurrent work, or optimizing throughput.

Quality

73%

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/parallel-agent-spawner/SKILL.md

The canonical home for this skill is parallel-agent-spawner in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 leads with verified, executable Quick Start code and keeps bulk detail in scripts, but it has three recurring weaknesses: a padding ASCII diagram, no validation or failure-handling checkpoints for its batch spawn-and-merge workflow, and a reference structure that does not match the actual bundle (a missing references/ directory and a missing agent_pool.py). Fixing the broken file references and adding a validate-after-merge step would raise the score materially.

Suggestions

Remove or drastically shrink the ASCII execution-model diagram; the Quick Start code already communicates the orchestrator/worker/aggregator flow in a fraction of the tokens.

Add explicit validation checkpoints to the workflow, e.g. 'After wait_all(), check each AgentResult.status; retry or spawn error-recoverer for failures, resolve conflicts via result_aggregator, and only then merge' — the rubric caps batch workflows without validation at 3.

Fix the bundle references: create the missing references/PARALLELIZATION-STRATEGY.md and references/CONFLICT-RESOLUTION.md (or remove those entries), and remove or add scripts/agent_pool.py; also correct 'agent_type="coding"' to use the AgentType enum the script actually expects.

DimensionReasoningScore

Conciseness

The 27-line ASCII 'Parallel Execution Model' diagram restates the orchestrator-to-workers-to-aggregation flow that the Quick Start code and headings already convey — an explanation of a concept Claude already understands. The rest of the body is lean, so this is one clearly unnecessary block rather than 'several' padded sections, placing it at anchor 3 rather than 2; it cannot be 4 because that diagram is roughly a third of the body and earns no new information.

3 / 5

Actionability

The Quick Start code is real and verified against scripts/parallel_spawner.py — ParallelSpawner(project_dir), spawn_parallel(tasks=..., agent_type=...), wait_all(), and get_results_summary() all exist with those names. It falls short of anchor 5 on minor gaps: 'agent_type="coding"' passes a raw string where the script expects the AgentType enum, the SpawnConfig dataclass is shown but never wired into a usage example, and there is no end-to-end example of consuming the returned results.

4 / 5

Workflow Clarity

The Quick Start implies a sequence (spawn_parallel -> wait_all -> get_results_summary) but includes no validation checkpoints, no failure-handling flow (agent failure, merge conflict), and no guidance on when to check results before proceeding. Per the rubric's cap, a batch operation (spawning multiple agents that merge code changes) without validation steps cannot score above 3; it is above anchor 2 because the steps that are present are concrete and executable.

3 / 5

Progressive Disclosure

Scored against the actual bundle: the body is well-sectioned and points detail to separate files, but the entire references/ directory does not exist — both listed references (PARALLELIZATION-STRATEGY.md, CONFLICT-RESOLUTION.md) are dead — and scripts/agent_pool.py is also missing. Clearly signaled references that resolve to nothing break navigation, which is more than the 'minor organization gaps' of anchor 4; the section structure itself is good, placing it at anchor 3 rather than 2.

3 / 5

Total

13

/

20

Passed

Description

78%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 description with an explicit and specific 'Use when...' clause and natural trigger terms. Its main weakness is thin capability coverage — only two verbs — which leaves the skill's actual breadth (merging, conflict resolution, dependency analysis) undescribed. Trigger coverage is good but misses common user phrasings like 'run in parallel' or 'fan out'.

Suggestions

Expand the 'what' clause to name the skill's concrete capabilities, e.g. 'Spawn and coordinate parallel agents, analyze task dependencies, and merge concurrent results for faster completion.'

Add natural trigger variations users would actually say, such as 'run tasks in parallel', 'fan out work across agents', or 'speed up feature completion'.

DimensionReasoningScore

Specificity

The description names the domain ('parallel agents') and exactly two concrete actions — 'Spawn and coordinate' — matching the anchor for 1-2 concrete actions without comprehensive coverage. It omits capabilities the skill actually has (merging results, conflict resolution, dependency analysis), keeping it below the 'several specific actions' anchor; the actions named are concrete, not generic, so it sits above anchor 2.

3 / 5

Completeness

It clearly answers 'what' ('Spawn and coordinate parallel agents for faster completion') and 'when' with an explicit 'Use when...' clause listing four concrete trigger phrases, matching the anchor for both-what-and-when with concrete triggers. The when-clause is explicit and specific, so it does not fit the anchor 4 case where 'when' could be more explicit.

5 / 5

Trigger Term Quality

'running parallel tasks, spawning subagents, coordinating concurrent work' are natural phrases a user would say, giving good keyword coverage. It falls short of anchor 5 because common variations and synonyms are missing ('run in parallel', 'fan out', 'speed up', 'concurrent agents'), and 'optimizing throughput' leans toward jargon; it exceeds anchor 3 because the terms present are ones users naturally use rather than technical-only phrasing.

4 / 5

Distinctiveness Conflict Risk

The subagent/parallel-agent framing carves a clear niche with mostly distinct triggers, fitting the 'mostly distinct; minor overlap risk' anchor. It is not a 5 because 'running parallel tasks' and 'optimizing throughput' are broad enough to fire for non-agent parallelization or throughput work; it is above anchor 3 because the agent/subagent terminology is a recognizable, specific niche.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/parallel-agent-spawner/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.