CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workers-best-practices

Reviews and authors Cloudflare Workers code against production best practices. Load when writing new Workers, reviewing Worker code, configuring wrangler.jsonc, or checking for common Workers anti-patterns (streaming, floating promises, global state, secrets, bindings, observability). Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

72

Quality

91%

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

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

Well-structured skill body: dense rule/anti-pattern tables, a clear 8-step review workflow with a validation step, and a proper two-file reference bundle that is real, one level deep, and clearly signaled. Main weaknesses are minor: triplicated retrieval instructions and no inline code examples or error-recovery loop.

Suggestions

Consolidate the 'Retrieval Sources' table and the 'FIRST: Fetch Latest References' section (including the npm pack bash block, which duplicates the same command in references/review.md) into one retrieval step to remove redundancy.

Add one short inline TypeScript snippet showing a correct pattern (e.g., ctx.waitUntil() usage or a timing-safe secret comparison) so the body's rules are executable without opening references.

Close the workflow loop after step 7: state what to do when tsc/lint or retrieval fails before flagging (e.g., 'if unsure after validation, fetch the specific doc page before reporting').

DimensionReasoningScore

Conciseness

Dense rule tables with no padding and no explanation of concepts Claude already knows, but retrieval instructions appear three times — the "Retrieval Sources" table, the "FIRST: Fetch Latest References" section, and a bash block that duplicates the same npm pack command already in references/review.md. That is a trim candidate, placing it at 'efficient with minor over-explanation' rather than the lean 5.

4 / 5

Actionability

Concrete commands are present (npm pack for latest types, `npx tsc --noEmit`, `wrangler secret put`, `wrangler types`) and every rule table names specific APIs and flags rather than vague direction. However, TypeScript code examples are entirely deferred to references/rules.md, so the body's guidance is mostly-executable with a minor gap — the 4 anchor.

4 / 5

Workflow Clarity

The 8-step Review Workflow is clearly sequenced and includes a validation checkpoint ("Validate with tools — `npx tsc --noEmit`, lint for `no-floating-promises`"), with retrieve-before-flagging as a first step. It stops short of the 5 anchor because there is no explicit error-recovery loop (what to do when validation or retrieval fails before flagging).

4 / 5

Progressive Disclosure

Both referenced files (references/rules.md, 463 lines; references/review.md, 174 lines) exist, are one level deep, and are clearly signaled with their purpose ("all best practice rules with code examples and anti-patterns"; "type validation, config validation, binding access patterns, review process"). The body keeps terse quick-reference summaries inline and defers details appropriately — a clear overview with well-signaled references.

5 / 5

Total

17

/

20

Passed

Description

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

Excellent description: third-person, concrete multi-action statement of what, an explicit 'Load when' clause with four concrete triggers, and domain-distinct terms including the wrangler.jsonc file format. All four dimensions sit at the top anchor.

DimensionReasoningScore

Specificity

Names multiple concrete actions — "Reviews and authors Cloudflare Workers code", "configuring wrangler.jsonc", "checking for common Workers anti-patterns (streaming, floating promises, global state, secrets, bindings, observability)" — with concrete sub-areas. Comprehensive coverage for the domain, matching the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

Explicitly answers both: what ("Reviews and authors Cloudflare Workers code against production best practices") and when ("Load when writing new Workers, reviewing Worker code, configuring wrangler.jsonc, or checking for common Workers anti-patterns"). The explicit 'Load when...' clause with four concrete triggers matches the 5 anchor exactly; the presence of that clause also lifts it above the level-3 cap.

5 / 5

Trigger Term Quality

Natural trigger phrases users would say ("writing new Workers", "reviewing Worker code", "streaming", "secrets", "bindings", "observability") plus the config file extension "wrangler.jsonc", giving comprehensive coverage including synonyms and extensions as the 5 anchor requires.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Cloudflare Workers specifically) with distinct triggers like "wrangler.jsonc" and Workers-specific anti-patterns. Third-person voice is used correctly, and nothing generic is present that would fire adjacent skills (Durable Objects, Workflows, Wrangler) unintentionally.

5 / 5

Total

20

/

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

openai/plugins

Path

plugins/cloudflare/skills/workers-best-practices/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.