CtrlK
BlogDocsLog inGet started
Tessl Logo

flow-nexus-platform

Comprehensive Flow Nexus platform management - authentication, sandboxes, app deployment, payments, and challenges

60

5.55x
Quality

41%

Does it follow best practices?

Impact

100%

5.55x

Average score across 3 eval scenarios

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

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

Quality

Discovery

32%

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 identifies a specific platform (Flow Nexus) and lists broad capability areas, which provides some useful context. However, it lacks concrete action verbs describing what operations are performed, and critically, it has no 'Use when...' clause to guide skill selection. The capability areas listed are too high-level to serve as effective triggers.

Suggestions

Add a 'Use when...' clause specifying trigger conditions, e.g., 'Use when the user asks about Flow Nexus, managing sandboxes, deploying apps to Flow Nexus, or configuring Flow Nexus payments.'

Replace category nouns with specific action phrases, e.g., 'Authenticates users, creates and manages sandboxes, deploys applications, processes payments, and configures challenges on the Flow Nexus platform.'

Include alternative terms or file types users might reference, such as specific Flow Nexus CLI commands, API names, or common task descriptions.

DimensionReasoningScore

Specificity

The description names a specific domain ('Flow Nexus platform') and lists several action areas (authentication, sandboxes, app deployment, payments, challenges), but these are categories rather than concrete actions. It doesn't describe what specific operations are performed (e.g., 'create sandboxes', 'deploy apps', 'process payments').

2 / 3

Completeness

The description answers 'what' at a high level (platform management across several areas) but completely lacks any 'when' guidance — there is no 'Use when...' clause or equivalent explicit trigger guidance. Per the rubric, a missing 'Use when...' clause should cap completeness at 2, and since the 'what' is also only at a category level, this scores a 1.

1 / 3

Trigger Term Quality

It includes some relevant keywords like 'authentication', 'sandboxes', 'app deployment', 'payments', and 'challenges', which users might mention. However, 'Flow Nexus' is a specific platform name that helps, but common variations or alternative phrasings users might use are missing.

2 / 3

Distinctiveness Conflict Risk

The mention of 'Flow Nexus platform' provides some distinctiveness since it's a specific platform name. However, broad terms like 'authentication', 'payments', and 'app deployment' could overlap with other skills that handle those domains in different contexts.

2 / 3

Total

7

/

12

Passed

Implementation

50%

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

This skill is essentially a comprehensive API reference manual inlined into a single massive file. While it excels at actionability with complete, executable MCP tool call examples for every operation, it is severely bloated with marketing content (subscription tiers, revenue sharing details), generic advice (tips for success, best practices), and categorical enumerations that don't help Claude perform tasks. The workflow lacks validation checkpoints for multi-step and destructive operations.

Suggestions

Cut the file by 60-70% by removing subscription tier details, cost optimization tips, achievement type descriptions, challenge category lists, publishing best practices, troubleshooting FAQ, and support links — these are documentation, not skill instructions.

Add explicit validation checkpoints to the Quick Start workflow (e.g., 'Check auth_status response before proceeding' after login, 'Verify sandbox status is running before executing code').

Extract the detailed API reference sections into separate bundle files (e.g., sandbox-api.md, payments-api.md) and keep SKILL.md as a concise overview with links to those files.

Remove generic advice sections ('Tips for Success', 'Cost Optimization Tips', 'Best Practices') that Claude can infer or that belong in user-facing documentation rather than an agent skill.

DimensionReasoningScore

Conciseness

Extremely verbose at ~700+ lines. Contains extensive lists of tips, best practices, achievement types, subscription tiers, cost optimization advice, troubleshooting guides, and category enumerations that Claude doesn't need explained. Much of this is marketing/documentation content rather than actionable skill instructions.

1 / 3

Actionability

Every API call is shown with complete, executable MCP tool invocations including realistic parameter examples. The code snippets are copy-paste ready with clear parameter names and values, covering the full range of platform operations.

3 / 3

Workflow Clarity

The Quick Start Guide provides a reasonable 5-step sequence, but lacks validation checkpoints — there's no guidance on checking if registration succeeded before logging in, verifying sandbox creation before executing code, or handling failures at any step. For destructive operations like sandbox deletion and file deletion, no confirmation or validation steps are mentioned.

2 / 3

Progressive Disclosure

Uses HTML details/summary tags for advanced patterns which is a good technique, but the main body is a monolithic wall of content that should be split into separate files. References to external docs exist but the skill itself contains hundreds of lines of inline content (pricing tiers, category lists, tips) that could be externalized. No bundle files support the structure.

2 / 3

Total

8

/

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 (1176 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/ruvector
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.