CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-sample-sweep

Run the pre-release end-to-end sweep of every user-facing surface — the 33 samples under samples/ (booted from their packaged artifacts and driven in a real browser via chrome-devtools MCP), the Expo/React Native client, and the atmosphere CLI. Use before cutting a release, and after any change to the Console bundle, a shared module, atmosphere.js, the CLI, or several samples at once. Covers preconditions, the keyless Ollama backend, the per-sample launch/drive/collect/teardown loop, the evidence ledger, the fix phase (every issue gets a biting regression test in the right suite), the re-test subset, and the report.

Quality

93%

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

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

An exemplary process skill: fully executable commands and a clearly sequenced, validation-gated workflow, with detail correctly split into one-level-deep reference files that all exist and are cited where needed. Its only weakness is modest verbosity in historical anecdotes and low-level port mechanics that could be trimmed or moved to references.

DimensionReasoningScore

Conciseness

Nearly every line carries operational specifics — exact commands, ports, env-var names — with no explanation of concepts Claude already knows, placing it above anchor 3. It sits at anchor 4 rather than 5 because of trimmable narrative: the historical-incident anecdotes ('that is what happened on the 2026-08-07 shakedown') and the WebTransport UDP-port mechanics paragraph could be tightened or pushed to references.

4 / 5

Actionability

Fully executable throughout: 'git status --porcelain # must be clean', './mvnw install -DskipTests -Pfastinstall', 'grep 'AI config:' target/sweep/<sample>-<port>.log', the complete 'sweep-sample.sh start <sample> --port <9101+n> --ready-path <path> --env LLM_MODE=local' invocation, exact model names ('qwen2.5:3b', 'qwen2.5:7b-instruct-q4_K_M'), and a copy-paste attestation JSON template. This matches the 5 anchor — copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

Steps 0–5 are explicitly sequenced with validation checkpoints at every risky point (clean-tree check, launcher that 'refuses to boot if the port is already answering', teardown that 'verifies the port is actually released', PASS/PARTIAL/FAIL evidence rules) plus an explicit feedback loop — 'Repeat triage → fix → re-test until the sweep is clean'. For a 33-sample batch operation this matches the 5 anchor with validation, error recovery, and checklists all present.

5 / 5

Progressive Disclosure

Verified against the actual bundle: all seven references/, the script, and the asset exist with real content, and each is cited at the exact point of use (references/expo-sweep.md at Step 1b, references/cli-sweep.md at Step 1c, references/regression-specs.md at Step 3). References are one level deep with no nested pointers, and the 'Files in this skill' table aids discovery — matching the 5 anchor. Not a 4: there is no content that clearly belongs in a separate file still inlined; the body keeps only the orchestration procedure.

5 / 5

Total

19

/

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 highly effective description: it states concrete capabilities across the full sweep lifecycle and gives explicit, condition-based 'Use when...' triggers grounded in specific repo surfaces. The only gap is a few natural synonyms that could widen trigger matching.

DimensionReasoningScore

Specificity

Enumerates multiple concrete actions with comprehensive coverage — 'booted from their packaged artifacts and driven in a real browser via chrome-devtools MCP', 'the per-sample launch/drive/collect/teardown loop', 'the evidence ledger, the fix phase (every issue gets a biting regression test in the right suite), the re-test subset, and the report'. Every phrase names a distinct capability with no padding, matching the 5 anchor; it exceeds 4 because the phase list is complete rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both: what — 'Run the pre-release end-to-end sweep of every user-facing surface — the 33 samples... the Expo/React Native client, and the atmosphere CLI'; when — 'Use before cutting a release, and after any change to the Console bundle, a shared module, atmosphere.js, the CLI, or several samples at once'. Concrete trigger phrases match the 5 anchor exactly; a 4 would require the 'when' to be less explicit than this.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: 'release', 'sweep', 'samples', 'chrome-devtools', 'Console', 'CLI', 'Expo client' — phrases a maintainer would actually say. It falls short of the 5 anchor ('comprehensive coverage including synonyms and file extensions') because variations like 'E2E', 'smoke test', or 'pre-release check' are absent.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers — repo-specific surfaces ('33 samples under samples/', 'the atmosphere CLI', 'chrome-devtools MCP') make it unmistakable and virtually impossible to trigger for the wrong skill. It is not a 4 because there is no realistic overlap with even 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

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

Atmosphere/atmosphere

Path

.claude/skills/release-sample-sweep/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.