CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-coordinator-swarm-init

Agent skill for coordinator-swarm-init - invoke with $agent-coordinator-swarm-init

54

2.80x
Quality

32%

Does it follow best practices?

Impact

87%

2.80x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-coordinator-swarm-init/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%Weight 40%Scale 1-3

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-structured with concrete memory-coordination keys and executable hook commands, but it is held back by a duplicated YAML block, repetitive emphasis, and abstract core-workflow guidance lacking validation checkpoints. It is a competent instruction draft that needs tightening and concrete verification steps.

Suggestions

Remove the duplicated/malformed second YAML frontmatter block (lines 6-31) so the body is pure markdown and no tokens are wasted on a stray config blob.

Add explicit validation/verification steps with feedback loops for the swarm-init workflow, e.g. a concrete check that each spawned agent has written its initial status before proceeding, with a retry-on-missing procedure.

Make the topology/resource-configuration steps actionable instead of descriptive — give concrete decision criteria or commands for choosing hierarchical vs mesh and for setting agent limits, rather than "Allocates compute resources based on task complexity."

DimensionReasoningScore

Conciseness

The body is mostly tight bullet lists but includes a duplicated/malformed YAML block (the second --- block) and repetitive ALL-CAPS emphasis (MANDATORY/ENFORCES/VERIFIES) that could be tightened, fitting the mostly-efficient-but-could-be-tighter anchor.

2 / 3

Actionability

It gives concrete, executable pieces — memory key patterns like swarm/[agent-name]$status and real hook commands (npx claude-flow@alpha memory store ...) — but the core topology/resource workflow stays abstract ("Allocates compute resources based on task complexity"), so guidance is incomplete rather than copy-paste ready.

2 / 3

Workflow Clarity

The 5-step memory protocol is clearly sequenced, but the broader workflow lacks explicit validation checkpoints and the asserted "VERIFIES agents are writing status updates" has no check/retry procedure; per the rubric, missing validation for multi-agent batch operations caps this at 2.

2 / 3

Progressive Disclosure

There are no bundle files and the content is a single self-contained SKILL.md, but it is well-organized into clear sections (Purpose, Core Functionality, Usage, Integration, Best Practices, Error Handling) with no nested references, which meets the simple-skill allowance for a 3.

3 / 3

Total

9

/

12

Passed

Description

7%Weight 40%Scale 1-3

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 is a boilerplate label that fails to state concrete actions, natural trigger terms, or explicit use-when guidance, leaving its only differentiator the skill name itself. It reads as an auto-generated placeholder rather than a purposeful trigger description.

Suggestions

Replace the tautological label with concrete actions, e.g. "Initializes agent swarms, selects topology, and configures shared-memory coordination across agents."

Add an explicit Use-when clause with natural trigger terms users would say, e.g. "Use when setting up multi-agent swarms, choosing mesh/hierarchical/ring topologies, or coordinating agents via shared memory."

Drop the generic "Agent skill for... - invoke with $..." template framing so the description communicates purpose rather than invocation mechanics.

DimensionReasoningScore

Specificity

The description only states "Agent skill for coordinator-swarm-init" — a tautological label naming a domain but zero concrete actions, matching the vague/abstract anchor rather than naming any operations.

1 / 3

Completeness

Both "what" (a vague "Agent skill for...") and "when" (no Use-when clause) are very weak, so it falls into the missing-what-OR-when anchor rather than the has-what-but-implied-when level.

1 / 3

Trigger Term Quality

The only trigger is the literal command "invoke with $agent-coordinator-swarm-init"; there are no natural keywords a user would actually say, fitting the no-natural-keywords/technical-jargon anchor.

1 / 3

Distinctiveness Conflict Risk

The named domain "coordinator-swarm-init" gives it a slight niche, but it lacks distinct triggers and uses generic template phrasing, so it could still overlap with other swarm/coordination skills.

2 / 3

Total

5

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ruvnet/claude-flow
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.