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 ./skills/parallel-agent-spawner/SKILL.md
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 is well organized with executable, API-accurate code examples, but it is padded by a large conceptual ASCII diagram, lacks validation/feedback checkpoints for a batch spawning-and-merging workflow, and lists reference and script files that are absent from the bundle. The structure is sound; the depth and verification steps are missing.

Suggestions

Replace the 27-line ASCII diagram with one or two sentences describing the orchestrator → workers → aggregator flow, freeing tokens for the missing validation workflow.

Add explicit checkpoints to the workflow: after wait_all(), inspect per-agent status, retry or handle failed agents (retry_failed), and validate merged results before declaring completion — this is a batch operation that currently has no feedback loop.

Fix the broken bundle references: either create references/PARALLELIZATION-STRATEGY.md, references/CONFLICT-RESOLUTION.md, and scripts/agent_pool.py, or remove those entries — dead links currently route users to nonexistent conflict-resolution guidance.

DimensionReasoningScore

Conciseness

Most of the body is efficient (code snippets, tables, config), but the ~27-line ASCII 'Parallel Execution Model' diagram illustrates a concept Claude already understands — an orchestrator spawning workers and aggregating results — making up nearly a third of the body. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim level-4 anchor.

3 / 5

Actionability

The Quick Start code is real and executable — the API shown (ParallelSpawner, spawn_parallel, wait_all, get_results_summary) matches scripts/parallel_spawner.py, and the SpawnConfig dataclass mirrors the actual source. It stops short of level 5: 'project_dir' is never defined, there is no example of what a task entry looks like, and handling failures or merge results is only implied.

4 / 5

Workflow Clarity

A rough sequence exists (spawn → wait_all → get_results_summary), but there are no validation checkpoints for this batch operation — no step to inspect failed agents, verify merges, or resolve conflicts before proceeding. Per the scoring note on batch operations missing feedback loops, workflow clarity is capped at 3: 'Steps listed but validation gaps; checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

Sections are well organized and references are clearly signaled, but scoring against the actual bundle reveals that references/PARALLELIZATION-STRATEGY.md and references/CONFLICT-RESOLUTION.md do not exist (no references/ directory) and scripts/agent_pool.py is missing. Navigation paths lead to dead ends — including conflict resolution, a topic nowhere else covered — which is more than the 'minor organization gaps' of level 4.

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 concise, well-structured description with an explicit 'Use when...' trigger clause and natural keywords. Its main limitation is thin action coverage — only spawn and coordinate are stated, without the downstream capabilities (merge, retry, dependency analysis) the skill actually provides.

DimensionReasoningScore

Specificity

The description names the domain ('parallel agents') and exactly two concrete actions — 'Spawn and coordinate parallel agents' — matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not reach the level-4 anchor, which expects several listed actions (e.g., merge results, retry failures, analyze dependencies).

3 / 5

Completeness

Both parts are explicit: the what ('Spawn and coordinate parallel agents for faster completion') and the when ('Use when running parallel tasks, spawning subagents, coordinating concurrent work, or optimizing throughput') with concrete trigger phrases. This mirrors the level-5 good example structure; it is not the level-4 case because the 'when' clause is already specific and multi-trigger.

5 / 5

Trigger Term Quality

Triggers include natural phrases users would say: 'running parallel tasks', 'spawning subagents', 'coordinating concurrent work', 'optimizing throughput'. Coverage is good but misses common synonyms such as 'fan out', 'run concurrently', or 'parallelize', so it does not reach the comprehensive level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The parallel-spawning/coordinating niche is mostly distinct with dedicated trigger terms, but 'optimizing throughput' is broad and the description could overlap with other orchestration/agent-management skills. This fits 'Mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict level-5 anchor.

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

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.