CtrlK
BlogDocsLog inGet started
Tessl Logo

cluster-orchestration

Use when you need to manage sessions across multiple wsh servers in a federated cluster. Examples: "distribute builds across several machines", "create sessions on a specific backend", "monitor health across a cluster of servers", "coordinate work across server boundaries".

64

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/cluster-orchestration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 strong in completeness and distinctiveness, with a clear 'Use when' clause and multiple natural trigger examples that define a specific niche. Its main weakness is that the core capability statement ('manage sessions across multiple wsh servers') is somewhat vague — it could benefit from listing more specific concrete actions beyond what's implied in the examples.

Suggestions

Add explicit concrete actions to the main capability statement, e.g., 'Creates, routes, and monitors sessions across multiple wsh servers in a federated cluster, handles load distribution and health checks.'

DimensionReasoningScore

Specificity

The description names the domain (federated cluster, wsh servers) and mentions some actions like 'manage sessions', 'distribute builds', 'monitor health', 'coordinate work', but these are mostly expressed through examples rather than as concrete listed capabilities. The actual 'what it does' is vaguely stated as 'manage sessions across multiple wsh servers'.

2 / 3

Completeness

The description explicitly answers both 'what' (manage sessions across multiple wsh servers in a federated cluster) and 'when' (starts with 'Use when' and provides multiple example trigger scenarios). The 'Use when' clause is present and well-structured with concrete examples.

3 / 3

Trigger Term Quality

Good coverage of natural trigger terms users would say: 'distribute builds across several machines', 'create sessions on a specific backend', 'monitor health across a cluster', 'coordinate work across server boundaries', 'federated cluster'. These are phrases users would naturally use when needing this skill.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to a niche domain — federated wsh server clusters, multi-machine session management. Terms like 'wsh servers', 'federated cluster', and 'server boundaries' are distinctive and unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

62%

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

This is a well-structured skill covering distributed terminal session management with clear workflows and good failure handling patterns. Its main weaknesses are verbosity (explaining concepts at length that could be more concise) and the use of pseudocode rather than executable examples, which limits actionability. The content would benefit from being split across multiple files given its length.

Suggestions

Replace pseudocode patterns with concrete examples — either actual wsh_* tool calls or curl commands — so guidance is copy-paste ready rather than abstract.

Trim the 'Concepts' and 'When to Use' sections significantly; Claude can infer when distribution is appropriate and doesn't need detailed explanations of hub/backend architecture.

Split detailed sections (failure handling, tag-based workflows, pitfalls) into separate referenced files to reduce the main SKILL.md to a concise overview with navigation links.

DimensionReasoningScore

Conciseness

The skill is reasonably well-written but verbose for its content. The concepts section explains hub/backend architecture and health states at length, and some sections like 'When to Use Cluster Orchestration' and 'Choosing Where to Place Work' explain decision-making that Claude could infer. The execution context preamble is also lengthy. However, most content is domain-specific and not general knowledge Claude would already have.

2 / 3

Actionability

The skill uses pseudocode-style instructions ('create session "build" on server "prod-1"', 'list servers') rather than executable code or concrete API calls/curl commands. While the execution context preamble explains this is intentional (mapping to wsh_* tools or HTTP fallback), the actual guidance remains abstract — there are no real tool invocations, no concrete curl examples, and no executable code blocks. The patterns are clear but not copy-paste ready.

2 / 3

Workflow Clarity

Multi-step workflows are clearly sequenced with explicit validation checkpoints. The 'Waiting for Backends to Become Healthy' section includes a polling loop pattern. The 'Coordinating Sequential Stages' section shows a clear send/wait/read/verify pipeline. Failure handling includes concrete recovery strategies with check-before-proceed patterns and partial failure collection. The fan-out and sequential stage patterns have clear feedback loops.

3 / 3

Progressive Disclosure

The content is a single monolithic file with no references to supporting documents despite being over 250 lines. The execution context preamble references 'skills/core/SKILL.md' for HTTP fallback, but the main body could benefit from splitting detailed failure handling, tag-based workflows, and pitfalls into separate referenced files. The internal organization with headers is good, but the overall length suggests content should be split.

2 / 3

Total

9

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
deepgram/wsh
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.