CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

check-workshop-ready

Check that a laptop and fork are ready for the Tessl Carnival workshop (git, Node, the GitHub CLI, the Tessl CLI and credits, and a fork with Issues, Actions, Pages and the interaction lock on), then report a short pass or fix list. Only checks, and changes nothing without asking. Use when someone asks to check they're ready for the workshop, or before they start the core path in workshop/agent.md.

Quality

92%

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

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.

A tight, fully executable read-only checklist: every item pairs an exact command with a pass criterion and a concrete fix, sequencing and dependencies are explicit, and error recovery is covered. The only deductions are a small time-sensitive version aside and structure that is solid but sits just outside the simple-skill sweet spot for progressive disclosure.

DimensionReasoningScore

Conciseness

The body is almost entirely command + pass criterion + fix with no padding ("git: `git --version`. Pass if it prints a version."), but the aside "When this skill was written it was `^22.13.0 || >=24`: Node 22.13 or later, skipping Node 23" is time-sensitive version detail with semver unpacking that could be trimmed. That is a minor instance of over-explanation, matching the 4 anchor rather than 5's every-token-earns-its-place, and well above 3.

4 / 5

Actionability

Every check has a copy-paste-ready command (`gh api repos/OWNER/REPO/pages --jq '[.build_type, .html_url] | @tsv'`, `curl -sS -o /dev/null -w '%{http_code}' <html_url>`), an explicit pass criterion, and a concrete fix covering the common failure cases (not installed / installed with npm / not logged in), plus a worked report example. This matches the 5 anchor fully; 4 would require gaps in the commands or fixes, which are absent.

5 / 5

Workflow Clarity

Clear 12-step sequence across three sections with per-step validation (explicit pass criteria), dependency handling ("Run every check, even after one fails, unless it needs an earlier one"; "Skip the rest of this section until it passes"), an error-recovery loop ("A 404 straight after setup can mean the first deploy is still running: check with `gh run list ...`"), and a checklist-style report with next-step escalation. It fits the 5 anchor's explicit validation + feedback loops; the skill is read-only, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Sections are well organized (laptop / fork / report), everything is appropriately inline for a self-contained checklist, and no bundle files exist so nothing should be split out. At roughly 85 lines it sits just past the under-50-line simple-skill exception for a 5, and the 5 anchor also presumes well-signaled one-level-deep references, so the 4 anchor (good structure, content appropriately placed) is the best fit; it is far from 3, which requires inlined content that clearly belongs in separate files.

4 / 5

Total

18

/

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 that comprehensively enumerates what is checked, states the output and a check-only safety boundary, and gives an explicit Use-when clause with two concrete triggers. Its only weakness is trigger coverage that misses a few natural phrasings like setup or pre-flight check.

DimensionReasoningScore

Specificity

The description enumerates the complete set of concrete checks — "git, Node, the GitHub CLI, the Tessl CLI and credits, and a fork with Issues, Actions, Pages and the interaction lock on" — and states the output ("report a short pass or fix list") and boundary ("changes nothing without asking"). Coverage is comprehensive, matching the 5 anchor; 4 would require minor gaps in the listed actions.

5 / 5

Completeness

It explicitly answers both questions: what ("Check that a laptop and fork are ready... then report a short pass or fix list. Only checks, and changes nothing without asking") and when ("Use when someone asks to check they're ready for the workshop, or before they start the core path in workshop/agent.md"). The explicit Use-when clause with two concrete triggers matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

"check they're ready for the workshop" and "ready for the workshop" are natural phrases a user would say, backed by "Tessl Carnival" and "core path in workshop/agent.md". Common variants like "setup", "prepared", or "pre-flight check" are absent, so it fits the 4 anchor (good coverage, a few natural terms missing) rather than 5's comprehensive synonym coverage, and is clearly above 3.

4 / 5

Distinctiveness Conflict Risk

"Tessl Carnival workshop" readiness is a clear niche with workshop-specific triggers (the workshop itself and workshop/agent.md's core path), giving minimal overlap with any other skill. Voice is third person/imperative throughout, so no voice penalty applies; this fits the 5 anchor's clear niche with distinct triggers.

5 / 5

Total

19

/

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

Cornebidouille/tessl-carnival

Path

skills/check-workshop-ready/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.