CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

88%

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.

The body is an exemplary lean operational runbook: every section pairs a costly trap with an executable command or a precise fix, and verification notes (real deploy vs --dry-run, monorepo-wide test gate) are included where they matter. The only soft spot is that a couple of production-impacting sequences lack explicit post-change validation checkpoints.

DimensionReasoningScore

Conciseness

The body is lean and trap-focused with zero padding: each section states the operational trap and gives a command or a precise fix, with no explanation of concepts Claude already knows (e.g., no Cloudflare or wrangler primer). This matches anchor 5 ('every token earns its place') and is clearly above anchor 4, which would require some over-explanation to trim.

5 / 5

Actionability

Commands are copy-paste ready and cover the common cases: 'bunx wrangler tail <worker-name> --env production', the full extract-and-pipe secret one-liner with printf, 'bunx wrangler deploy --env production', and 'bun run test'. Diagnostics are equally concrete (module-top-level 'fileURLToPath(import.meta.url)', 'process.env', and the note that '--dry-run' does not catch the crash). Placeholders like KEY and $SF are contextual variables rather than pseudocode, so this is anchor 5, not anchor 4's 'minor gaps'.

5 / 5

Workflow Clarity

Each trap is a self-contained, well-ordered procedure — section 1 mandates tailing 'before forming any theory', section 4 includes a real-deploy verification, and section 6 defines the pre-merge test gate — so most checkpoints are present (anchor 4). It falls short of anchor 5 because a few production-impacting flows (e.g., the secret set + redeploy of sections 2-3) lack an explicit validate-after-the-change checkpoint, yet it is well above anchor 3, where validation would be merely implicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose per its numbered sections, and has no bundle files; per the simple-skills note, well-organized sections alone earn anchor 5. The six titled sections are scannable and each is independently addressable, with no inlined content that belongs in a separate file and no nested references.

5 / 5

Total

19

/

20

Passed

Description

78%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, niche-scoped description with explicit use-when triggers and several concrete, recognizable trigger phrases. Its main weakness is that the 'what' is delivered as a partly vague topic list ('where to look first') rather than crisp capability statements, and a couple of common synonyms (e.g., 'wrangler') are absent.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — a Worker that 'misbehaves or fails to deploy', 'setting or rotating a Worker secret', the 'secret-setting trap for JSON and JWK values', and the 'module-evaluation crash on a first deploy' — but omits the routes-inheritance and shared-schema topics, leaving minor gaps in coverage. It matches anchor 4 ('lists several specific actions; minor gaps') rather than anchor 5, which requires comprehensive coverage of all capabilities, and is well above anchor 3, which would allow only 1-2 concrete actions.

4 / 5

Completeness

It has an explicit 'when' ('Use when this repository's Cloudflare Worker misbehaves or fails to deploy, or when setting or rotating a Worker secret') and a 'what' ('Covers where to look first, the secret-setting trap...'), so both are present per anchor 4. It falls short of anchor 5 because the 'what' is an indirect topic list — 'Covers where to look first' is vague — rather than clearly explicit capability statements with concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'Cloudflare Worker', 'misbehaves', 'fails to deploy', 'setting or rotating a Worker secret', 'JSON and JWK'. A few natural terms users would plausibly say are missing, such as 'wrangler', 'deploy error', or 'secret put', so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5, while clearly exceeding the generic-keyword anchors 2-3.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche: operational debugging of this repository's specific Cloudflare Worker deployment, secrets, and deploys. Triggers ('misbehaves', 'fails to deploy', 'Worker secret', 'redeploy') are distinct and would not fire for unrelated skills, matching anchor 5 with minimal conflict risk.

5 / 5

Total

17

/

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

Path

.claude/skills/debug-workers/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.