CtrlK
BlogDocsLog inGet started
Tessl Logo

flow-nexus-swarm

Cloud-based AI swarm deployment and event-driven workflow automation with Flow Nexus platform

45

1.88x
Quality

17%

Does it follow best practices?

Impact

100%

1.88x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agents/skills/flow-nexus-swarm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

7%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is heavily padded with buzzwords and technical jargon without conveying concrete actions or use cases. It lacks a 'Use when...' clause, specific trigger terms users would naturally say, and any enumeration of what the skill actually does. The only redeeming quality is the mention of a specific platform name ('Flow Nexus'), which provides minimal distinctiveness.

Suggestions

Replace abstract buzzwords with concrete actions the skill performs, e.g., 'Deploys AI agent swarms to cloud infrastructure, configures event triggers, monitors workflow pipelines on the Flow Nexus platform.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about deploying agents to Flow Nexus, setting up automated workflows, or managing cloud-based AI pipelines.'

Include natural keywords and file types or concepts users would mention, such as 'deploy', 'automate', 'pipeline', 'Flow Nexus', 'swarm config', or specific workflow terms.

DimensionReasoningScore

Specificity

The description uses buzzword-heavy, abstract language ('cloud-based AI swarm deployment', 'event-driven workflow automation') without listing any concrete actions the skill performs. There are no specific verbs describing what it actually does.

1 / 3

Completeness

The description vaguely hints at 'what' through buzzwords but provides no clear explanation of concrete capabilities, and there is no 'when' clause or explicit trigger guidance whatsoever.

1 / 3

Trigger Term Quality

The terms used are highly technical jargon ('AI swarm deployment', 'event-driven workflow automation', 'Flow Nexus platform') that users are unlikely to naturally say. There are no common, natural keywords a user would use when seeking this skill.

1 / 3

Distinctiveness Conflict Risk

The mention of 'Flow Nexus platform' is a specific platform name which provides some distinctiveness, but the rest of the description ('cloud-based', 'AI', 'workflow automation') is generic enough to overlap with many other skills.

2 / 3

Total

5

/

12

Passed

Implementation

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is a comprehensive but excessively verbose reference document that tries to cover everything in a single file. While it provides concrete MCP tool call syntax, it suffers from significant redundancy (topology/strategy guides repeated, concepts over-explained), lacks validation checkpoints for multi-step cloud operations, and fails to leverage progressive disclosure by inlining all content rather than splitting into focused reference files.

Suggestions

Reduce content by 60-70%: remove explanations of concepts Claude knows (what topologies are, what CI/CD is, what ETL means), eliminate the 'Common Use Cases' section which adds no actionable value, and deduplicate the topology/strategy guides that appear multiple times.

Add explicit validation checkpoints to multi-step workflows: after swarm_init check status before spawning agents, after workflow_create verify success before executing, include error handling patterns with concrete status-checking steps.

Split content into multiple files: keep SKILL.md as a concise overview with quick-start example, move patterns to PATTERNS.md, templates to TEMPLATES.md, and API reference to API.md with clear one-level-deep references.

Show expected output/response schemas for key MCP tool calls so Claude knows what to expect and can validate results programmatically.

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Extensively explains concepts Claude already knows (what topologies are, what ETL means, what CI/CD is). Massive amounts of redundant information — topology guide repeated, strategy guide repeated, agent types explained unnecessarily. The 'Common Use Cases' section is pure filler with no actionable content. Best practices section restates things already covered.

1 / 3

Actionability

Provides concrete MCP tool call syntax with parameters and options, which is useful. However, many examples are not truly executable — they use `await` syntax mixed with bare function calls inconsistently, return values are referenced but never shown, and the multi-swarm coordination example uses JavaScript async/await patterns that wouldn't work in an MCP tool-calling context. The workflow patterns are illustrative but lack expected output schemas.

2 / 3

Workflow Clarity

The Full-Stack Development Pattern shows a clear multi-step sequence (init → spawn → create workflow → execute), but there are no validation checkpoints or error recovery steps. For cloud-based deployment and orchestration — which involves destructive/batch operations — the absence of explicit validation steps (check swarm status before proceeding, verify workflow creation succeeded, handle failures) caps this at 2.

2 / 3

Progressive Disclosure

Monolithic wall of text with no bundle files or external references for detailed content. Everything is inlined in a single massive document — the API reference, all patterns, all templates, best practices, setup instructions. The table of contents provides internal navigation but the content itself should be split across multiple files (e.g., TEMPLATES.md, PATTERNS.md, API-REFERENCE.md). No bundle files exist to support progressive disclosure.

1 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

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.