CtrlK
BlogDocsLog inGet started
Tessl Logo

compute-env-setup

Prepare reproducible setup instructions and validate a user-managed named software environment on an Open-Science SSH Compute Host, including direct SSH and Slurm hosts. Use when a remote job needs packages, modules, cache variables, or a repeatable activation that the host does not already provide.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

Highly actionable content: every step is backed by executable JavaScript or Bash, the workflow has explicit validation checkpoints and a diagnose-by-layer recovery loop, and safety boundaries around user-owned durable resources are consistently enforced. The only weak spots are mild repetition of the ownership rules and a single long file that could offload host-fact or scheduler detail into a reference file if the skill grows.

DimensionReasoningScore

Conciseness

The body is efficient: it teaches only non-obvious Open-Science contract facts (dual '~/.openscience'/'~/.open-science' paths, ownership boundaries, no-poll job semantics) and never explains concepts Claude already knows like conda or Slurm basics. There is minor repetition that could be trimmed — the user-ownership/durability rule is restated in the intro, the 'Prepare user-owned installation and removal' section, and the removal guidance — placing it at anchor 4 rather than the every-token-earns-its-place lean of anchor 5, and well above the padded verbosity of anchor 3.

4 / 5

Actionability

Guidance is fully executable throughout: copy-paste JavaScript for listing hosts ('host.compute.listHosts()'), a batched read-only probe via 'compute.callCommand(...)', a complete conda activation file example, direct-SSH and Slurm witness jobs via 'compute.submitJob(...)' with explicit options, and an append snippet for 'host.compute.details'. Placeholders like '<provider-known-partition>' and '<date>' are host-specific and clearly flagged, so the examples cover the common cases as anchor 5 requires.

5 / 5

Workflow Clarity

The sequence is explicit and well-ordered: start from the Session catalog, probe read-only, define the environment, prepare a user-run installation plan, validate with a witness, then record host facts. Validation checkpoints are explicit ('An import alone is insufficient', the witness must pass, non-zero sourcing is job failure) and there is a feedback loop ('When validation fails, diagnose the layer identified by the error... Prepare revised user-run commands'). The destructive removal operations are guarded with verification requirements, satisfying the batch/destructive validation bar.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), and the body references no external files, so there are no nested or buried references to penalize. The single file is well-sectioned (Define the environment / Prepare user-owned installation and removal / Validate where jobs run / Record reusable host facts) with all content appropriately inline for an operating-procedure skill; at ~180 lines it is not the trivial sub-50-line case that would earn a 5, so anchor 4 (good structure, most content appropriately placed) is the best fit.

4 / 5

Total

18

/

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 description: it explicitly states both what the skill does and when to use it, with concrete domain-specific triggers (packages, modules, cache variables, activation, Slurm, SSH) and a niche that avoids conflicts. Keyword coverage could add common synonyms such as conda, venv, or cluster, and the action list could mention the removal/record facets present in the body.

DimensionReasoningScore

Specificity

The description names the domain ('Open-Science SSH Compute Host, including direct SSH and Slurm hosts') and two concrete actions ('Prepare reproducible setup instructions and validate a user-managed named software environment'), with scope detail ('packages, modules, cache variables, or a repeatable activation'). It lists several specific capabilities but not comprehensively (e.g., removal and host-fact recording are not mentioned), which fits anchor 4 better than the complete coverage of anchor 5 and clearly above the 1-2 actions of anchor 3.

4 / 5

Completeness

The 'what' is explicit ('Prepare reproducible setup instructions and validate a user-managed named software environment...') and the 'when' is a concrete explicit trigger clause ('Use when a remote job needs packages, modules, cache variables, or a repeatable activation that the host does not already provide'), matching anchor 5. It is not anchor 4 because the 'when' clause is already specific and condition-listing rather than needing more explicitness.

5 / 5

Trigger Term Quality

Natural terms users would say are present: 'packages', 'modules', 'remote job', 'SSH', 'Slurm', 'activation'. Common variations a user might naturally say are missing, such as 'conda', 'venv', 'cluster', 'compute node', or 'environment variables' as a synonym for 'cache variables', so it fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than the comprehensive synonym/extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche — named environment activation on Open-Science SSH/Slurm compute hosts via sourcing '~/.open-science/environments/<name>.sh' — with triggers ('remote job needs packages, modules, cache variables, or a repeatable activation') that would rarely fire for a generic setup or document skill. This matches anchor 5 (clear niche with distinct triggers; minimal conflict risk), not anchor 4 which implies residual overlap with closely related skills.

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
aipoch/open-science
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.