Cloudflare Deploy

Free skill for Claude Code · MIT licence

Free skill on GitHub Premium pack, $15, on Agensi

Cloudflare Deploy is a skill for Claude Code that sets up and deploys a site on Cloudflare Pages and Workers without the failures that cost a day each. An AI agent deploying to Cloudflare from memory gets the same things wrong, every time. This skill teaches the agent the six hard rules that stop those failures, plus the setup checklists and the error-diagnosis guide. They were learned from real deployments, where each rule is a failure that already happened once.

Who it is for

Developers who deploy sites on Cloudflare Pages and Workers, and anyone who has watched a deploy fail and then spent a day finding out it was the deploy route, not the code.

The problem

  1. It deploys a Pages site through a direct-upload route, and the site serves HTTP 500 on every path.
  2. It redeploys a Worker without the full bindings list, and the metadata replace wipes the D1 database and rate limit bindings.
  3. It never checks the compatibility date, and the config drifts away from the deploy tool.
  4. It runs a build and a deploy at the same time, and the failure looks like a deploy bug.
  5. It changes app.js without bumping the version query string, and browsers keep serving the old copy.

What is in the free skill

  • cloudflare-deploy/SKILL.md: the six hard rules, the first-setup order, the Pages deploy procedure, the Worker redeploy procedure, how to add a binding, secret, or cron trigger, and how to diagnose a broken deploy.
  • cloudflare-deploy/references/setup-checklists.md: the setup checklists for DNS, Pages, Workers, Email Routing, and D1.
  • cloudflare-deploy/references/error-diagnosis.md: the error-diagnosis guide. Symptom, likely cause, check, fix.
  • cloudflare-deploy/INSTALL.md: install steps for Claude Code, Codex CLI, Cursor, and Claude.ai.
  • cloudflare-deploy/examples/wrangler-example.toml: a complete, good example Worker config. Copy its shape, replace every example value.
  • cloudflare-deploy/examples/deploy-config-example.json: an example deploy config for the premium deploy-check script.
  • cloudflare-deploy/examples/deploy-checklist.md: the pre-deploy checklist.

Install

git clone https://github.com/WebSmartTools/cloudflare-deploy.git
mkdir -p ~/.claude/skills
cp -r cloudflare-deploy ~/.claude/skills/

See cloudflare-deploy/INSTALL.md in the repo for Codex CLI, Cursor, and Claude.ai.

How to use it

Ask Claude Code to set up or deploy a site on Cloudflare. The skill follows the six hard rules: Pages deploys go through Wrangler, Worker redeploys carry the full bindings list, the compatibility date is checked, builds and deploys run one at a time, and the version query string is bumped whenever a script or stylesheet changes.

Premium pack

The premium pack adds five things the free skill does not have, for $15, one-time payment, single-user licence, on Agensi:

  • deploy-check.py: a script that checks a wrangler.toml plus a deploy config before you deploy. It catches a missing project name, a missing main file, a missing or malformed compatibility date, a bad route, a binding the deploy config expects but the config does not declare, and a secret that is listed but never set. With --dist it also warns on script and stylesheet references without a version query string, so browsers do not keep serving the old copy after a change. Python 3, no dependencies.
  • references/full-stack-wrangler.toml: a complete reference Worker config (D1, two rate limit bindings, cron trigger, route) with example values to replace.
  • references/github-actions-deploy.yml: a GitHub Actions workflow template that deploys a Pages site and a Worker from the main branch, running the checker first as a gate.
  • references/monorepo-wrangler.toml: a monorepo blueprint for a project with a Pages frontend and two Workers.
  • deploy-verification-checklist.md: the post-deploy live verification steps, the checks that prove a deploy actually worked.

The free skill stays free, MIT licensed. The premium pack has its own single-user licence and is not open source.

Questions

Which AI tools does it work with?

The skill is written for Claude Code. The repo's INSTALL.md has the install steps for Codex CLI, Cursor, and Claude.ai.

Is the free skill really free?

Yes. The free skill is MIT licensed, free forever. The premium pack is $15, one-time payment, single-user licence, and it is not open source.

More skills