CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

offload-onboard

Onboard a repository to use Offload for parallel test execution on Modal. Detects test setup, creates config, Dockerfile, CI job, and optimizes performance.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/offload-onboard/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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-checkpointed onboarding procedure whose executable templates and validation loops are excellent. Its weaknesses are structural: a monolithic single-file layout with no references/ bundle, duplicated troubleshooting content, and a step-numbering error (Step 10 missing) that slightly mars navigation.

Suggestions

Move the configuration field reference, the CI workflow template, and the Troubleshooting/.dockerignore section into references/ files (e.g. references/config.md, references/ci.md, references/troubleshooting.md) and link them from the body, keeping SKILL.md as an overview.

Fix the step numbering: Step 9 jumps directly to Step 11 (no Step 10), and Step 13's decline branch says "skip Steps 13 and 14" while inside Step 13 — renumber and reword.

Deduplicate troubleshooting: Step 8's "Common issues and fixes" list and the Troubleshooting Reference table cover the same errors — keep one and reference it from the other.

DimensionReasoningScore

Conciseness

The body is dense and command-driven, but troubleshooting items ("Exec format error", "Token validation failed", "No such file or directory") are repeated verbatim in both Step 8's fix list and the Troubleshooting Reference table, and the Dockerfile git-comment blocks are duplicated across the Python and Rust templates. Mostly efficient, but several sections could be tightened.

3 / 5

Actionability

Fully executable throughout: complete Dockerfile templates, offload.toml variants for pytest/cargo/default frameworks, a copy-paste scripts/offload-tests.sh, a full GitHub Actions workflow, and a symptom/cause/fix troubleshooting table. Placeholders are explicitly flagged ("values in <angle-brackets> are placeholders you must substitute"), and common cases (pytest, cargo, vitest, monorepo) each get concrete examples.

5 / 5

Workflow Clarity

Steps are clearly sequenced with strong validation checkpoints and feedback loops ("Do not continue until all prerequisites are confirmed", "Repeat until offload collect succeeds", baseline comparison before optimization, "Do not proceed until they match"). Not 5 because step numbering skips Step 10 entirely (Step 9 jumps to Step 11) and Step 13's "If they decline, skip Steps 13 and 14" self-references confusingly — minor coherence gaps, not missing validation.

4 / 5

Progressive Disclosure

No references/ bundle exists; the full configuration field reference, CI workflow template, and troubleshooting guide are all inlined in a single ~585-line SKILL.md, with only a vague external pointer ("see the Offload README") instead of well-signaled bundle files. Section headers give reasonable structure, so this sits at "some structure, content that should be separate is inline".

3 / 5

Total

15

/

20

Passed

Description

70%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 specific, distinctive description that clearly conveys what the skill does and produces which artifacts, undermined only by the missing 'Use when...' trigger clause and a slightly vague "optimizes performance" tail. Adding explicit trigger guidance would lift it substantially.

Suggestions

Append a trigger clause, e.g.: "Use when the user asks to run tests in parallel, speed up a slow test suite, mentions Offload, or wants cloud-based test execution on Modal."

Replace "optimizes performance" with the concrete optimization performed, e.g. "tunes max_parallel via runtime benchmarking".

Include one or two framework keywords users would naturally say (e.g. "pytest", "vitest", "cargo nextest") to broaden natural-term coverage.

DimensionReasoningScore

Specificity

"Detects test setup, creates config, Dockerfile, CI job, and optimizes performance" lists several concrete actions with clear domain (Offload, parallel test execution, Modal). Not 5 because "optimizes performance" is vague and some outputs (local invocation script, .gitignore changes) are unstated; clearly above 3 with four-plus named actions.

4 / 5

Completeness

The description has a clear "what" (onboard a repository to Offload for parallel test execution on Modal) but no "Use when..." clause or equivalent explicit trigger guidance, which per the rubric caps completeness at 3.

3 / 5

Trigger Term Quality

Natural phrases a user would say include "parallel test execution", "test setup", "Dockerfile", "CI job", and "Modal". Not 5 because common variations like "run tests faster", "speed up tests", "test suite", or framework names (pytest/cargo/vitest) are missing; better than 3 since keyword coverage is good rather than partial.

4 / 5

Distinctiveness Conflict Risk

"Offload" and "Modal" name a specific niche with distinct triggers; the combination of parallel cloud test execution with Modal sandboxes is unlikely to fire for unrelated skills.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (585 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

imbue-ai/offload

Path

skills/offload-onboard/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.