CloudflareKnown publishercloudflare/skills/skills/workers-development/SKILL.md

workers-development

Skill3.3k starsChanged 18 days agoApache-2.0View on GitHub

Run, inspect, and debug Cloudflare Workers during local development with cf dev, wrangler dev, or the Cloudflare Vite plugin, using Local Explorer to read and seed binding data and query local traces and logs. Also routes production debugging to Workers observability. Use for debugging requests whether or not the project uses Wrangler.

Sep 21, 2026Install Cloudflare agent skills — dceoy/docker-ai-coder1 reaction
Aug 9, 2026chore: add Cloudflare skills via npx skills add — jussray/solcontinuity1 reaction
Jun 18, 2026chore(toolkit): track cloudflare/skills + ponytail external deps — stevengonsalvez/agents-in-a-box1 reaction · 2 comments
Feb 20, 2026building-mcp-server-on-cloudflare — AAswordman/OperitSkillMarket1 reaction
Feb 20, 2026building-ai-agent-on-cloudflare — AAswordman/OperitSkillMarket1 reaction

15 more on GitHub

Nov 6, 2026[#1002217] CF-AGENT-SETUP-1: load Cloudflare Skills and the Cloudflare API MCP (Code Mode) into the fleet command-line agent — QNFO/qnfo-workers0 reactions
Oct 15, 2026[Feature] Include Autohand Code CLI in Cloudflare skills installation — cloudflare/workers-sdk0 reactions
Sep 26, 2026[Candidate] cloudflare/skills/skills/cloudflare-email-service - cloudflare-email-service — ProSkillsMD/proskills0 reactions · 1 comment
Sep 26, 2026[Candidate] cloudflare/skills/skills/cloudflare - cloudflare — ProSkillsMD/proskills0 reactions · 2 comments
Sep 26, 2026[Candidate] cloudflare/skills/skills/agents-sdk - agents-sdk — ProSkillsMD/proskills0 reactions · 1 comment
Sep 21, 2026blocked-patterns / authority-injection false positives on imported technical docs; add consumer-side suppression — mrwogu/promptscript0 reactions
Sep 9, 2026feat: Lesson - Skills — agentschools/cfdev.school0 reactions
Aug 6, 2026Skills lesson: `npx skills add` installs to the project, not globally — add the scope flag — agentschools/opencode.school0 reactions
Aug 5, 2026changed — faiqqoyash12-ui/skills0 reactions
May 28, 2026Dependency Dashboard — gtbuchanan/dotfiles0 reactions
Mar 27, 2026better UX — Brunwo/converge-skills0 reactions
Feb 20, 2026wrangler — AAswordman/OperitSkillMarket0 reactions
Feb 20, 2026web-perf — AAswordman/OperitSkillMarket0 reactions
Feb 20, 2026durable-objects — AAswordman/OperitSkillMarket0 reactions
Feb 20, 2026agents-sdk — AAswordman/OperitSkillMarket0 reactions

On Bluesky · 4

Jul 2, 2026AIエージェントにCloudflare上での開発方法を教え込むためのスキルセット集らしいエージェントを活用して効率よくアプリ開発を進めたいときに試したい yug1224 starred cloudflare/skills… — @yug1224.com1 likes and repost
Jul 2, 2026AIエージェントにCloudflare上での開発方法を学習させるためのスキル集らしい AIを活用した開発を効率化できそうで今すぐ試したい yug1224 starred cloudflare/skills https://github.com/cloudflare/skills — @yug1224.com1 likes and repost
Jul 2, 2026AIエージェントにCloudflare上での開発や構築方法を学習させるためのスキルセット集らしいエージェントを活用して開発効率を上げたいときに便利そう yug1224 starred cloudflare/skills… — @yug1224.com1 likes and repost
May 15, 2026I've been using cloudflare for some of my projects and saw that they had an agent skill repo when I was first trolling around the docs.… — @n0vsec.social1 likes and repost

In this repository21 other files it gives its agents.
- agents-sdkSkill
- basinSkill
- cf-cliSkill
- cloudflare-app-bootstrapSkill
- cloudflare-email-serviceSkill
- cloudflare-one-migrationsSkill
- cloudflare-oneSkill
- cloudflareSkill
- durable-objectsSkill
- frameworks-on-cloudflareSkill
- gateway-workersSkill
- k2Skill
- nextjs-on-cloudflareSkill
- sandbox-migrate-to-nextSkill
- sandbox-nextSkill
- sandbox-stableSkill
- turnstile-spinSkill
- web-perfSkill
- workers-best-practicesSkill
- workers-profilingSkill
- wranglerSkill

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Use the project's existing tooling, scripts, and configuration.
line 8
Distinctive:
If the user reports that this skill gave incorrect or outdated guidance, or is missing information, read references/skill-feedback.md.
line 25

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Workers development and debugging

Use the project's existing tooling, scripts, and configuration. Installed help, the Local Explorer API schema, and current docs describe the supported operations; read them rather than guessing endpoints or flags.

Need	Tools and discovery
Run locally	Use the project's existing dev command: `cf dev` in a `cf` project, otherwise the Wrangler or Cloudflare Vite dev script. See local development.
Inspect or seed local binding data	Local Explorer is a UI and API for local KV, R2, D1, SQLite-backed Durable Objects, and Workflows, and can trigger Cron handlers. Open `/cdn-cgi/local/explorer` on the dev server's origin.
Debug local requests	Local Explorer captures traces and logs from every local invocation, including binding operations, without code changes. Check traces before adding logging.
Debug a deployed Worker	Choose logs, traces, or metrics with Workers observability, or the `cloudflare` skill's observability reference when installed. If the Cloudflare MCP server is connected (bundled with this plugin), use `search` to find the Workers Observability API operations, then `execute` to call them, scoped to the target account, Worker, and time window.

Use the Local Explorer API

When the dev server detects an AI agent, including under cf dev, it prints a hint with the API URL and relevant endpoints. Fetch the OpenAPI specification from /cdn-cgi/local/explorer/api on the dev server's origin, then extract only the operations the task needs. If no hint appears, request that URL directly. If the API or an operation is missing, compare the installed Wrangler or Vite plugin version against the requirements in the Local Explorer docs.

Bindings are simulated locally by default, but a binding set to remote: true reaches the real deployed resource while the Worker runs locally. Traces also capture those remote calls. Identify which bindings are remote before seeding or writing data.

Skill feedback

If the user reports that this skill gave incorrect or outdated guidance, or is missing information, read references/skill-feedback.md.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free