Agent skill · Cloudflare
Workers Best Practices skill for Claude Code, Codex and Cursor
Officialname: workers-best-practices★ 3.2k (repo)pushed 2026-10-19Apache-2.0SKILL.md on GitHubchecked 2026-11-07
What it does, in the publisher's words
Cloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers.
The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.
Install Workers Best Practices
The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs
npx skills add cloudflare/skills --skill workers-best-practices
This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (cloudflare), or copy only this skill into ~/.claude/skills. docs
/plugin marketplace add cloudflare/skills /plugin install <plugin>@cloudflare # or only this skill: npx skills add cloudflare/skills --skill workers-best-practices -a claude-code
Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs
git clone --depth 1 https://github.com/cloudflare/skills.git /tmp/workers-best-practices-src cp -r /tmp/workers-best-practices-src/skills/workers-best-practices ./workers-best-practices zip -r workers-best-practices.zip workers-best-practices
Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs
npx skills add cloudflare/skills --skill workers-best-practices -a codex
gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs
gh skill install cloudflare/skills workers-best-practices
Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs
npx skills add cloudflare/skills --skill workers-best-practices -a cursor
Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs
gemini skills install https://github.com/cloudflare/skills.git --path skills/workers-best-practices
OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs
npx skills add cloudflare/skills --skill workers-best-practices -a opencode
Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs
npx skills add cloudflare/skills --skill workers-best-practices -a windsurf
Works with
Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.
What's in the SKILL.md
- References
- Keep Compatibility Dates Current
- Enable Observability
- Place Compute Near Regional Databases
- Anti-Patterns to Flag
- Validation
- Scope
- Skill feedback
Bundled files
- references/configuration.md
- references/platform-apis.md
- references/runtime-patterns.md
- references/skill-feedback.md
Loaded only when the instructions point to them.
Facts
- Skill name
- workers-best-practices
- Publisher
- Cloudflare (official)
- Repo
- cloudflare/skills
- License
- Apache-2.0
- SKILL.md size
- 726 words, 64 lines
- Bundled files
- 4, 4 docs
- Repo stars
- 3.2k (as of 2026-10-24)
- SKILL.md checked
- 2026-11-07
Pairs with the Cloudflare MCP server: the server gives the agent the tools, the skill teaches it how to use them.
More skills from cloudflare/skills
- Cloudflare Agents SDK: Builds, debugs and reviews agents written with Cloudflare's agents package.
- Cloudflare Platform: Helps pick Cloudflare products for an app's compute, storage, AI, networking and security needs.
- Durable Objects: Writes and reviews Durable Objects code for stateful coordination on Cloudflare.
- Next.js on Cloudflare: Builds or moves Next.js apps to Cloudflare Workers, comparing vinext and OpenNext.
- Web Performance Audit: Diagnoses slow pages and improves Core Web Vitals and Lighthouse performance scores.
- Wrangler CLI: Runs and troubleshoots Wrangler commands for local dev, previews, deploys and resources.
Related cloud & devops skills
- Deploy to Vercel · Vercel
- GitHub: Fix CI · OpenAI
- gcloud CLI · Google
- Azure Deploy · Microsoft (Azure)
- Azure Diagnostics · Microsoft (Azure)
- Azure Prepare (azd) · Microsoft (Azure)
- New Terraform Provider · HashiCorp
- Terraform Style Guide · HashiCorp
FAQ
What does the workers-best-practices skill do?+
Production guidance for writing, configuring and reviewing Cloudflare Workers. In its own SKILL.md, Cloudflare describes it as: "Cloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers."
How do I install the workers-best-practices skill?+
Run npx skills add cloudflare/skills --skill workers-best-practices and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/workers-best-practices/SKILL.md; in Codex and Cursor in .agents/skills/workers-best-practices/.
Does Workers Best Practices work in Codex, Cursor and Copilot, or only Claude?+
It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.
Who maintains Workers Best Practices?+
Cloudflare, the company or project behind it, in the cloudflare/skills repo on GitHub, last pushed 2026-10-19. License: Apache-2.0.
Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers