CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

uncloud

Use when managing an Uncloud cluster — deploying services, configuring Caddy ingress, adding static proxy routes for non-cluster devices, publishing ports, scaling, inspecting logs, or managing machines and volumes with the `uc` CLI.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

A highly actionable, well-structured CLI reference with executable commands, complete compose examples, and a validated multi-step workflow for external device routing. Main gaps are the absence of any bundle files (bulk reference material is fully inlined) and missing verification steps in the semi-destructive workflows.

Suggestions

Move the CLI Quick Reference and Compose File Extension catalogs into a bundled reference file (e.g., references/cli.md) linked from SKILL.md with a one-level-deep pointer, keeping SKILL.md as a lean overview.

Add verification steps to semi-destructive workflows (e.g., check service state after `uc machine rm` or `uc deploy --recreate`, confirm replicas after `uc scale`), turning them into validate-then-proceed sequences.

Trim the 'When to Activate' section (it duplicates the frontmatter description) and merge 'How It Works' overlap with 'Core Concepts' to tighten token usage.

DimensionReasoningScore

Conciseness

Mostly lean tables and copy-paste commands that assume Claude's competence (no explaining Docker or Compose basics). Minor redundancy: 'When to Activate' restates the frontmatter description and 'How It Works' overlaps 'Core Concepts', keeping it below the 'every token earns its place' anchor.

4 / 5

Actionability

Fully executable throughout: concrete `uc` commands with flags, complete compose examples with `x-ports`/`x-caddy`/`x-machines`, and a copy-paste-ready external-device recipe (`uc service run --name device-bmc --caddyfile ~/device.caddyfile registry.k8s.io/pause:3.9`). Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

The external-device routing workflow is a clear numbered 3-step sequence with an explicit verify checkpoint ('uc caddy config — device block should appear'). Not 5 because other workflows (deploy, scale, `uc machine rm`, `uc deploy --recreate`) lack validation or verification steps despite being semi-destructive; well above 3 since the flagship multi-step process does have an explicit checkpoint.

4 / 5

Progressive Disclosure

Well-organized headers make the single file navigable, but with no bundle files at all, ~345 lines — including a full CLI quick reference and a compose-extension catalog — are inlined when the bulk reference material could live in a separate one-level-deep file. Matches anchor 3 ('structure present, content that should be separate is inline'); not 2 because sections are clear and navigable, not 4 because no references are used to split content.

3 / 5

Total

16

/

20

Passed

Description

92%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 strong description: concrete, comprehensive action list tied to a niche tool with an explicit 'Use when' trigger clause and no fluff. Only minor room to add a few more natural trigger variations (DNS, compose, machine updates).

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 'deploying services, configuring Caddy ingress, adding static proxy routes for non-cluster devices, publishing ports, scaling, inspecting logs, or managing machines and volumes' — with comprehensive coverage, matching the top anchor. Not 4 because there are no notable coverage gaps among the skill's documented capabilities.

5 / 5

Completeness

Explicitly answers both what (the enumerated actions with the `uc` CLI) and when ('Use when managing an Uncloud cluster') with concrete trigger phrases, mirroring the top anchor's pattern. Not 4 because the 'when' is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Good keyword coverage of natural user phrasing ('deploying services', 'publishing ports', 'scaling', 'inspecting logs', 'Caddy ingress'), but a few natural terms are missing (e.g., DNS, compose files, machine updates). Fits anchor 4 ('good coverage, a few natural terms missing') better than 5, which expects synonyms and fuller variations.

4 / 5

Distinctiveness Conflict Risk

'Uncloud cluster' and the `uc` CLI name a clear niche with distinct triggers; minimal conflict risk with any other skill. Clearly matches the top anchor rather than 4, which allows minor overlap with closely related skills.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/uncloud/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.