CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workers-best-practices

Cloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./.commandcode/skills/workers-best-practices/SKILL.md

The canonical home for this skill is workers-best-practices in cloudflare/skills

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.

The body is a well-structured, lean review skill: concrete anti-patterns with preferred patterns, exact configuration keys and API names, verified one-level-deep references, and an explicit validation section. The main gaps are a handful of vague directives (sampling configuration, 'relevant runtime tests') and a topical rather than strictly sequenced workflow.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no concept tutorials, no padded prose — with every section carrying review-relevant guidance. A few clauses state consequences Claude already knows (e.g. 'Leaks credentials through version control', 'Predictable values'), which is anchor 4's 'minor instances of over-explanation that could be trimmed' rather than the fully lean anchor 5.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: exact setting names ('observability.enabled', 'observability.traces.enabled'), exact APIs ('crypto.randomUUID()', 'ctx.waitUntil(...)'), and an exact command ('wrangler types'). A few directives remain vague — 'configure sampling for the workload' and 'run relevant runtime tests' give no mechanism — which is the minor-gap profile of anchor 4 rather than fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

The skill establishes a coherent review sequence — baseline installed versions/types, read the relevant reference, apply the named practices, then validate — and includes an explicit Validation section ('type-check binding or handler contract changes, and run relevant runtime tests'). It is organized topically rather than as a numbered sequence with per-step checkpoints, and the validation step lacks a retry/feedback loop, so it sits at anchor 4 rather than 5. No destructive/batch cap applies since this is a review skill.

4 / 5

Progressive Disclosure

A clear overview body splits detail into three one-level-deep reference files, each signaled by a table with a 'When to use it' column, and every anchored link in the body (e.g. configuration.md#enable-workers-logs-and-traces, platform-apis.md#serialization-boundaries) resolves to a real heading in the bundle. This matches anchor 5's 'well-signaled one-level-deep references; easy navigation'.

5 / 5

Total

17

/

20

Passed

Description

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

The description has an explicit and well-targeted 'Use when' clause and a distinct niche, but the capability statement is abstract — it says 'best practices' without naming any concrete actions. Adding one or two specific capabilities would raise both specificity and completeness.

Suggestions

Replace the abstract 'best practices for production applications' with 2-3 concrete capabilities, e.g. 'Reviews Workers code for streaming, bindings, and security anti-patterns; configures compatibility dates, observability, and secrets for production.'

Add natural trigger synonyms users actually say — 'wrangler', 'deploying Workers', 'edge functions' — to the 'Use when' clause to improve keyword coverage.

Keep the third-person voice and current length; the trigger clause structure already matches the strong examples in the rubric.

DimensionReasoningScore

Specificity

The description names the domain clearly ("Cloudflare Workers best practices for production applications") but the 'what' contains no concrete action verbs — 'best practices' is generic, unlike anchor-3 examples such as 'Processes PDF files and extracts content'. The verbs that do appear (writing, reviewing, configuring) all sit in the 'when' clause, so the capability statement itself stays at the domain-naming level of anchor 2.

2 / 5

Completeness

Both parts are present: the 'what' is stated up front and the 'when' is an explicit 'Use when writing, reviewing, or configuring Workers' clause with concrete trigger phrases. It falls short of anchor 5 only because the 'what' half is a single abstract phrase ('best practices') rather than a list of concrete capabilities, matching anchor 4's 'when could be more explicit or specific' territory in reverse — the 'what' could be more concrete.

4 / 5

Trigger Term Quality

"Cloudflare Workers", "Workers", and the activity terms "writing, reviewing, or configuring" are exactly what a user would naturally say, giving good keyword coverage. A few natural synonyms are missing (e.g. 'wrangler', 'deploying', 'edge'), which keeps it below anchor 5's comprehensive synonym coverage but clearly above anchor 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"Cloudflare Workers" is a clear niche with distinct, unambiguous triggers, and the skill body even delegates adjacent areas (Durable Objects, CLI) to other skills. Minimal conflict risk with other skills, matching anchor 5.

5 / 5

Total

15

/

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

MesilimLLC/api.trackdub

Path

.commandcode/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.