CtrlK
BlogDocsLog inGet started
Tessl Logo

debug-workers

Use when this repository's Cloudflare Worker misbehaves or fails to deploy, or when setting or rotating a Worker secret. Covers where to look first, the secret-setting trap for JSON and JWK values, why a secret change needs a redeploy, and the module-evaluation crash on a first deploy.

73

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

93%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 lean, highly actionable operational runbook: every trap is stated in 1-3 sentences with an executable command or a precise fix, and the section structure makes navigation trivial. The only weakness is that several fix sections (secret changes, route additions, schema changes) stop at the fix without telling the reader how to verify the change took effect.

DimensionReasoningScore

Conciseness

Every section is 1-3 sentences plus a single command; no space is spent on concepts Claude already knows — even "bash brace expansion mangles an unquoted {"a":"b"}" is a non-obvious operational trap, not padding. Lean and every token earns its place — matches anchor 5.

5 / 5

Actionability

Copy-paste-ready commands in the operational sections ("bunx wrangler tail <worker-name> --env production", the VAL=$(grep ...) extraction pipe into wrangler secret put, "bunx wrangler deploy --env production") and precise fixes elsewhere ("Move both into request-time code or lazy thunks", "Add [[env.production.routes]] with custom_domain = true"). Fully executable with specific examples covering the common cases — matches anchor 5.

5 / 5

Workflow Clarity

Clear sequencing with an observe-first checkpoint ("run wrangler tail ... before forming any theory about the architecture") and an explicit verification step ("Verify with a real wrangler deploy; --dry-run does not catch it"), but sections 2, 3, 5, and 6 end at the fix with no post-change verification. Clear sequence with most checkpoints present and minor validation gaps — anchor 4, not 5 due to those missing checkpoints.

4 / 5

Progressive Disclosure

The body is 47 lines with six clearly numbered, well-titled sections and no external references — per the simple-skill guidance, a short skill with no need for external files scores 5 with just well-organized sections. Every heading is scannable and each trap is self-contained.

5 / 5

Total

19

/

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 with an explicit 'Use when' trigger clause, concrete third-person coverage of the skill's main traps, and a tight niche that avoids conflicts. The main weaknesses are missing natural trigger synonyms (especially 'wrangler') and incomplete enumeration of the body's six traps.

Suggestions

Add 'wrangler' as a trigger term, since users debugging this repository's Worker will typically name the CLI rather than say 'Cloudflare Worker'.

Extend the coverage list to hint at the remaining body traps (named-environment routes not inheriting, shared-schema changes needing the monorepo test suite) so the description enumerates all capabilities.

DimensionReasoningScore

Specificity

Names several concrete covered scenarios — "misbehaves or fails to deploy", "setting or rotating a Worker secret", "the secret-setting trap for JSON and JWK values", "the module-evaluation crash on a first deploy" — but two body traps (named-environment route inheritance, shared-schema test suite) are unmentioned, leaving minor coverage gaps. Not 5 because coverage is incomplete; not 3 because far more than 1-2 actions are named.

4 / 5

Completeness

"Use when this repository's Cloudflare Worker misbehaves or fails to deploy, or when setting or rotating a Worker secret" is an explicit when-clause with concrete triggers, and "Covers where to look first, the secret-setting trap..., why a secret change needs a redeploy, and the module-evaluation crash on a first deploy" is a concrete what. Both are explicit — matches the anchor-5 example structure.

5 / 5

Trigger Term Quality

"fails to deploy" and "setting or rotating a Worker secret" are phrases a user would naturally say when they need this skill, but natural synonyms are missing — notably "wrangler" (the CLI users actually mention), plus variations like "deploy error" or "secret rotation". Not 5 for missing synonyms; clearly above 3's "some relevant keywords but missing common variations".

4 / 5

Distinctiveness Conflict Risk

Scoped tightly to "this repository's Cloudflare Worker" with distinct operational triggers (deploy failures, secret management), creating a clear niche with minimal conflict risk against generic debugging or deployment skills. No overlap risk evident.

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
englishstreetventures/englishstreetventures.com
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.