CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debug-workers

Use when a deployed Cloudflare Worker in this repository misbehaves or fails to deploy — osn-api, cire-api or a cire Worker — 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.

68

Quality

85%

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

86%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 lean troubleshooting skill: every section is a concrete, repo-specific trap with mostly executable commands, and bulk reference material is properly externalized to wiki files with a clear pointer. The only weaknesses are minor: an undefined `$SF` variable in the secret snippet and missing post-change verification for the production-mutating secret/deploy operations.

DimensionReasoningScore

Conciseness

The body is lean and trap-focused: each section states one gotcha in a sentence or two plus a command, assumes Claude's competence ("Move both into request-time code or lazy thunks"), and adds nothing Claude already knows. Every token earns its place; not 4 because there is no over-explanation to trim.

5 / 5

Actionability

Mostly copy-paste-ready commands: `bunx wrangler tail <worker-name> --env production`, the grep/sed/printf secret pipe, `bunx wrangler deploy --env production`, and the concrete `[[env.production.routes]]` directive. Minor gaps keep it from 5 — the secret snippet uses an undefined `$SF` variable and section 4 gives direction ("Move both into request-time code") without an example.

4 / 5

Workflow Clarity

Sections are numbered in a sensible order (tail the failing worker first, then secrets, then deploy) and section 4 includes an explicit verification checkpoint ("Verify with a real `wrangler deploy`; `--dry-run` does not catch it"). Not 5 because production-mutating operations in sections 2–3 (secret put, deploy) lack a post-change verification step; not 3 because a diagnostic-first sequence and one explicit checkpoint are present.

4 / 5

Progressive Disclosure

Under 50 lines with clear numbered sections, no bundle files, and bulk material (tier map, secrets checklist, deploy steps) correctly pushed to clearly-signaled wiki files (`wiki/shared/production-deploy.md`, `wiki/shared/dev-environment.md`) in the opening line — matching the simple-skill exception for well-organized short skills.

5 / 5

Total

18

/

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, repo-specific description with an explicit and concrete 'Use when' trigger clause plus a list of specific covered traps. Its main weakness is that the 'what' is phrased as a list of topics covered rather than the actions the skill performs, leaving it just below the top anchors on specificity and completeness.

Suggestions

Reframe the coverage list as actions the skill performs (e.g., 'Diagnoses and fixes misbehaving or failing Cloudflare Worker deploys, including ...') so the 'what' states capabilities, not table-of-contents entries.

Add one or two natural trigger terms users would say, such as 'wrangler' or 'deploy fails in production', to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description lists several specific covered items — "the secret-setting trap for JSON and JWK values", "why a secret change needs a redeploy", "the module-evaluation crash on a first deploy" — which are concrete and domain-anchored. It falls short of 5 because the items are topics covered rather than executable actions, and "where to look first" is generic.

4 / 5

Completeness

Both halves are present: an explicit trigger clause ("Use when a deployed Cloudflare Worker in this repository misbehaves or fails to deploy ... or when setting or rotating a Worker secret") and a stated scope ("Covers where to look first, ..."). Not 5 because the 'what' reads as a table of contents of topics rather than clearly stating what the skill does (diagnose and fix these failures).

4 / 5

Trigger Term Quality

Natural user phrases are present: "misbehaves", "fails to deploy", "setting or rotating a Worker secret", "redeploy". A few natural variations are missing (e.g., wrangler, deploy errors, production issues), keeping it below the comprehensive-synonyms anchor of 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche — debugging deployed Cloudflare Workers in this repository, naming specific workers (osn-api, cire-api), secrets, and deploy failures — with distinct triggers and minimal overlap risk with other skills. Not lower: no generic phrasing that a differently-scoped skill would also match.

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/osn

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.