workers-best-practices

Review Cloudflare Workers code against latest best practices and anti-patterns.

1|Updated Mar 12, 2026

Search Tags:#anti-patterns #review #cloudflare #wrangler #best-practices #workers

Ready to run

npx skills add https://github.com/mahou-labs/shiru --skill workers-best-practices-mahou-labs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: workers-best-practices
Source: https://github.com/mahou-labs/shiru/tree/main/.agents/skills/workers-best-practices
Command: npx skills add https://github.com/mahou-labs/shiru --skill workers-best-practices-mahou-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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.

Core Features & Use Cases

Retrieval of latest best practices from Cloudflare docs
Reference-based validation of type definitions and config, including wrangler.jsonc
Structured review workflow with guidelines and anti-pattern checks

Quick Start

Review your Worker code against the latest Cloudflare Workers best practices using retrieval sources.

Frequently Asked Questions about workers-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I check my Cloudflare Workers code for anti-patterns?▼

To check Cloudflare Workers code for anti-patterns, you can enforce best practices by reviewing global state, floating promises, and streaming logic against retrieved documentation. This validation ensures safe bindings and secure configuration.

What are common Cloudflare Workers anti-patterns to avoid during code reviews?▼

Common Cloudflare Workers anti-patterns include floating promises, improper global state usage, and unsafe streaming logic. Structured code reviews validate type definitions and wrangler.jsonc configurations to prevent these issues and enforce secure observability.

How do I validate wrangler.jsonc configuration for Cloudflare Workers?▼

You validate wrangler.jsonc configuration by referencing the latest Cloudflare config schemas and type definitions. This process enforces correct bindings, secures secrets, and ensures your setup follows production best practices.

Does this approach use pre-trained knowledge or retrieve Cloudflare docs for best practices?▼

This approach biases towards retrieval from Cloudflare docs rather than pre-trained knowledge. Retrieving the latest documentation ensures accurate validation of type definitions, config schemas, and observability rules during code reviews.

Can I enforce secure bindings and observability when writing new Workers?▼

You can enforce secure bindings and observability when writing new Workers by applying structured review workflows. These workflows check anti-patterns and validate configurations against retrieved Cloudflare docs for safe production deployment.