Workers Best Practices

Author or review Cloudflare Workers code for Workers-specific runtime, binding, streaming, concurrency, lifecycle, and configuration mistakes. Use when the user explicitly asks for Workers best-practice review or when implementing a new Worker entrypoint or binding boundary. Do not trigger for generic TypeScript review, ordinary application logic, deployment operations, or product selection.

201 stars 12 forksDevOps & Cloud

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add swyxio/skills --skill workers-best-practices
Manual install
git clone --depth 1 https://github.com/swyxio/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/workers-best-practices ~/.claude/skills/workers-best-practices

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Workers Best Practices

Retrieve current Cloudflare docs, installed Workers types, and the project's
Wrangler schema before asserting an API signature or configuration rule.

Load references selectively:

- [review.md](references/review.md) for a structured Workers review and current
  type/config retrieval.
- [rules.md](references/rules.md) for examples of specific runtime patterns.

## Inspect the Workers boundary

Read the full affected entrypoint, binding types, Wrangler environment, and the
callers of changed handlers. Check only Workers-specific risks supported by the
code:

- binding names and generated types match the selected environment;
- secrets are not stored in source or ordinary `vars`;
- request-scoped mutable state does not leak through module globals;
- request and response bodies are streamed when their size is not safely bounded;
- every promise is awaited, returned, deliberately detached with `waitUntil`, or
  explicitly discarded when safe;
- platform base classes use their current inheritance and `this.env` contract;
- Cloudflare services use bindings or service bindings when those are the
  intended application boundary; and
- cryptographic identifiers and secret comparisons use current Web Crypto APIs.

Do not flag a pattern merely because it differs from a preferred template.
Confirm that it is incorrect for the installed types, compatibility date, and
runtime path.

When serving static assets or an SPA, trace which requests reach the Worker
Read the full skill on GitHub

Details

Skill name
workers-best-practices
Repository
swyxio/skills
Path
workers-best-practices/SKILL.md
License
MIT
Repo updated
16 November 2026

FAQ

What does the Workers Best Practices skill do?

Author or review Cloudflare Workers code for Workers-specific runtime, binding, streaming, concurrency, lifecycle, and configuration mistakes. Use when the user explicitly asks for Workers best-practice review or when implementing a new Worker entrypoint or binding boundary. Do not trigger for generic TypeScript review, ordinary application logic, deployment operations, or product selection.

How do I install the Workers Best Practices skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add swyxio/skills --skill workers-best-practices. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Workers Best Practices popular?

It lives in swyxio/skills, which has 201 GitHub stars and 12 forks.

Related skills

Accelevents API

201

swyxio/skills

Use when reading or updating AI Engineer Europe speaker records through the Accelevents REST API, especially for full-record PUT updates, auth header quirks, and preserving existing speaker fields.

Software Development12

Accelevents Speaker Sync

201

swyxio/skills

Use when website speaker, session, schedule, room, track, or headshot changes must be synchronized back to Accelevents for AI Engineer Europe 2026.

AI, LLMs & Agents12

Agents SDK

201

swyxio/skills

Build or debug stateful applications that specifically use Cloudflare's `agents` package, including Agent classes, routing, callable methods, synchronized state, scheduling, AIChatAgent, durable execution, or Agents SDK client hooks. Do not trigger for generic AI-agent design, the OpenAI Agents SDK, or ordinary Durable Object work that does not use the Cloudflare Agents SDK.

AI, LLMs & Agents12

Wrangler

201

swyxio/skills

Resolve, construct, review, or run an exact Cloudflare Wrangler command or `wrangler.jsonc` change. Use when the user names Wrangler, asks for a Cloudflare CLI operation, or needs environment, binding, authentication, secret, migration, deployment, or resource-management syntax. Do not trigger for general Cloudflare architecture or application code that does not require Wrangler.

DevOps & Cloud12

Visual Playtest

201

swyxio/skills

Visually inspect a local or deployed site/app in a real browser and report concrete layout, responsive, or design regressions. Use when asked to visually check UI changes, reproduce a screenshot issue, compare a page with a reference, or playtest representative visual states. Do not use for code-only review or open-ended design ideation.

DevOps & Cloud12

Cloud Architect

121

theguysudo/ENZO

Designs cloud architectures, creates migration plans, generates cost optimization recommendations, and produces disaster recovery strategies across AWS, Azure, and GCP. Use when designing cloud architectures, planning migrations, or optimizing multi-cloud deployments. Invoke for Well-Architected Framework, cost optimization, disaster recovery, landing zones, security architecture, serverless design.

DevOps & Cloud29

Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.