CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

check-cloud-setup

Run a branch's setup hook on a Tessl cloud machine and report its output and what the machine then has, so factory setup can confirm the hook works in the cloud before it goes live. Use when factory setup launches a cloud run to check a setup hook.

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is tessl-labs/factory-setup

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an exemplary lean instruction sheet: exact commands, explicit success/failure criteria, an error-recovery loop, a clear no-side-effects constraint, and a precisely specified result artifact. Nothing is padded, missing, or misplaced for a skill of this scope.

DimensionReasoningScore

Conciseness

The ~30-line body is lean with every sentence carrying non-obvious instruction — why the hook runs twice ("The second run shows the hook is safe to run more than once"), which files may collide ("AGENTS.md and CLAUDE.md"), and the no-side-effects constraint. No padding or explanation of concepts Claude already knows, matching the anchor-5 example of every token earning its place.

5 / 5

Actionability

Guidance is fully executable: exact commands (`git fetch origin <branch>`, `CI=true bash .tessl/cloud-launch-setup.sh < /dev/null`, `node --version` etc.), precise exit-status handling, and exact field semantics for `launch-result.json` (status values, summary content, last 20 lines for reason). The only parameterization (`<branch>`) is inherently run-specific and resolved by the run's instructions, so there is no gap that would drop it to anchor 4.

5 / 5

Workflow Clarity

A clear 4-step sequence with explicit validation checkpoints — keeping each hook run's exit status and branching in step 4 on "both hook runs exit 0" versus failure — plus a feedback loop for error recovery in step 1 (checkout refused → delete named files → check out again → list in summary). This matches the anchor-5 pattern of explicit validation with retry loops; no destructive or batch operation lacks verification.

5 / 5

Progressive Disclosure

This is a simple single-purpose skill under 50 lines with no external references needed (no references/, scripts/, or assets/ files exist in the bundle), and the content is well organized as a brief orientation paragraph followed by numbered steps. Per the rubric's simple-skill note, this earns the top score on well-organized sections alone.

5 / 5

Total

20

/

20

Passed

Description

87%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, well-scoped description that states concrete actions, an explicit use-when trigger, and a distinct niche. Its only weakness is mild indirectness in phrasing ("what the machine then has") and limited synonym coverage in the trigger clause.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Run a branch's setup hook on a Tessl cloud machine", "report its output and what the machine then has", "confirm the hook works in the cloud before it goes live" — covering the task well. The phrase "what the machine then has" is slightly indirect compared to naming the reported artifacts, a minor gap that keeps it below the fully comprehensive anchor 5.

4 / 5

Completeness

Explicitly answers both questions: the "what" is running the branch's setup hook on the cloud machine and reporting its output plus resulting machine state, and the "when" is a concrete "Use when factory setup launches a cloud run to check a setup hook" clause. This matches the anchor-5 example pattern of clear what-and-when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural multi-word triggers like "setup hook", "cloud run", "check a setup hook", and "factory setup" match what a user in this domain would say. A few natural variations (e.g. "verify" or "test the hook") are missing, so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5, and is clearly above the sparse keyword level of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche keyed to domain-specific terms ("Tessl cloud machine", "factory setup", "cloud run to check a setup hook"), making it highly distinguishable from other skills with minimal wrong-trigger risk. Not score 4 because there is no meaningful overlap with neighboring skills — the triggers are uniquely identifying.

5 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

stephaniedominy/tessl-carnival

Path

.tessl/plugins/tessl-labs/factory-setup/skills/check-cloud-setup/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.