Skip to main content
skill CX Codex

cloudflare-deploy — Claude Code skill for Cloudflare deployments

cloudflare-deploy is a Claude Code skill for deploying apps and infrastructure to Cloudflare via Workers and Pages. It activates when publishing, hosting, or configuring a Cloudflare project.

Apache-2.0 ★ 7,191 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tech-leads-club/agent-skills --skill cloudflare-deploy -a claude-code
Open on GitHub

What cloudflare-deploy does

The skill covers the full Cloudflare stack: compute via Workers and Pages, storage via KV, D1, R2 and Queues, AI inference via Workers AI, security via WAF and Turnstile, media via Stream and Images. Built-in decision trees let the agent pick the right product for each task and load detailed references from the references/ directory.

Before any deploy, the skill checks authentication with npx wrangler whoami. Local work uses wrangler login; CI/CD pipelines need a CLOUDFLARE_API_TOKEN environment variable set. If the sandbox blocks outbound network calls, rerunning with sandbox_permissions=require_escalated is required.

This skill does not handle Vercel, Netlify, or Render — those platforms have their own dedicated skills.

What it helps with

  • deploy a Worker or Pages application to Cloudflare
  • set up KV, D1, or R2 storage for a project
  • connect Workers AI or AI Gateway to a service
  • pick the right Cloudflare product for a given task
  • configure wrangler authentication for a CI/CD pipeline

Example prompts for the agent

  • Deploy this app to Cloudflare Pages
  • Create a Cloudflare Worker to handle API requests and set up KV for caching
  • Connect D1 to the project and deploy using wrangler deploy

How to install cloudflare-deploy

1Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill cloudflare-deploy -a claude-code

2Manually: put the files in place

~/.claude/skills/cloudflare-deploy/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cloudflare-deploy/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cloudflare-deploy

How do I install cloudflare-deploy in Claude Code?

Run npx skills add tech-leads-club/agent-skills --skill cloudflare-deploy -a claude-code in your terminal. The skill will be available at ~/.claude/skills/cloudflare-deploy/SKILL.md.

What does the cloudflare-deploy skill do?

It gives the agent knowledge to deploy to Cloudflare — Workers, Pages, D1, R2, KV, Workers AI, and other platform services — along with decision trees to select the right product for each task.

Is authentication required before deploying?

Yes. The skill checks auth with npx wrangler whoami before running any deploy command. Without wrangler login completed locally, or CLOUDFLARE_API_TOKEN set for CI/CD, the deploy will fail.

Source text

SKILL.md · Apache-2.0
---
name: cloudflare-deploy
description: Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare. Do NOT use for deploying to Vercel, Netlify, or Render (use their respective skills).
metadata:
  author: github.com/openai/skills
  version: '1.0.0'
---

# Cloudflare Deploy

Consolidated skill for building on the Cloudflare platform. Use decision trees below to find the right product, then load detailed references.

## Prerequisites

- When sandboxing blocks the deployment network calls, rerun with `sandbox_permissions=require_escalated`.
- The deployment might take a few minutes. Use appropriate timeout values.

## Authentication (Required Before Deploy)

Verify auth before `wrangler deploy`, `wrangler pages deploy`, or `npm run deploy`:

```bash
npx wrangler whoami    # Shows account if authenticated
```

Not authenticated? → `references/wrangler/auth.md`

- Interactive/local: `wrangler login` (one-time OAuth)
- CI/CD: Set `CLOUDFLARE_API_TOKEN` env var

## Quick Decision Trees

### "I need to run code"

```
Need to run code?
├─ Serverless functions at the edge → workers/
├─ Full-stack web app with Git deploys → pages/
├─ Stateful coordination/real-time → durable-objects/
├─ Long-running multi-step jobs → workflows/
├─ Run containers → containers/
├─ Multi-tenant (customers deploy code) → workers-for-platforms/
├─ Scheduled tasks (cron) → cron-triggers/
├─ Lightweight edge logic (modify HTTP) → snippets/
├─ Process Worker execution events (logs/observability) → tail-workers/
└─ Optimize latency to backend infrastructure → smart-placement/
```

### "I need to store data"

```
Need storage?
├─ Key-value (config, sessions, cache) → kv/
├─ Relational SQL → d1/ (SQLite) or hyperdrive/ (existing Postgres/MySQL)
├─ Object/file storage (S3-compatible) → r2/
├─ Message queue (async processing) → queues/
├─ Vector embeddings (AI/semantic search) → vectorize/
├─ Strongly-consistent per-entity state → durable-objects/ (DO storage)
├─ Secrets management → secrets-store/
├─ Streaming ETL to R2 → pipelines/
└─ Persistent cache (long-term retention) → cache-reserve/
```

### "I need AI/ML"

```
Need AI?
├─ Run inference (LLMs, embeddings, images) → workers-ai/
├─ Vector database for RAG/search → vectorize/
├─ Build stateful AI agents → agents-sdk/
├─ Gateway for any AI provider (caching, routing) → ai-gateway/
└─ AI-powered search widget → ai-search/
```

### "I need networking/connectivity"

```
Need networking?
├─ Expose local service to internet → tunnel/
├─ TCP/UDP proxy (non-HTTP) → spectrum/
├─ WebRTC TURN server → turn/
├─ Private network connectivity → network-interconnect/
├─ Optimize routing → argo-smart-routing/
├─ Optimize latency to backend (not user) → smart-placement/
└─ Real-time video/audio → realtimekit/ or realtime-sfu/
```

### "I need security"

```
Need security?
├─ Web Application Firewall → waf/
├─ DDoS protection → ddos/
├─ Bot detection/management → bot-management/
├─ API protection → api-shield/
├─ CAPTCHA alternative → turnstile/
└─ Credential leak detection → waf/ (managed ruleset)
```

### "I need media/content"

```
Need media?
├─ Image optimization/transformation → images/
├─ Video streaming/encoding → stream/
├─ Browser automation/screenshots → browser-rendering/
└─ Third-party script management → zaraz/
```

### "I need infrastructure-as-code"

```
Need IaC? → pulumi/ (Pulumi), terraform/ (Terraform), or api/ (REST API)
```

## Product Index

### Compute & Runtime

| Product               | Reference                           |
| --------------------- | ----------------------------------- |
| Workers               | `references/workers/`               |
| Pages                 | `references/pages/`                 |
| Pages Functions       | `references/pages-functions/`       |
| Durable Objects       | `references/durable-objects/`       |
| Workflows             | `references/workflows/`             |
| Containers            | `references/containers/`            |
| Workers for Platforms | `references/workers-for-platforms/` |
| Cron Triggers         | `references/cron-triggers/`         |
| Tail Workers          | `references/tail-workers/`          |
| Snippets              | `references/snippets/`              |
| Smart Placement       | `references/smart-placement/`       |

### Storage & Data

| Product         | Reference                     |
| --------------- | ----------------------------- |
| KV              | `references/kv/`              |
| D1              | `references/d1/`              |
| R2              | `references/r2/`              |
| Queues          | `references/queues/`          |
| Hyperdrive      | `references/hyperdrive/`      |
| DO Storage      | `references/do-storage/`      |
| Secrets Store   | `references/secrets-store/`   |
| Pipelines       | `references/pipelines/`       |
| R2 Data Catalog | `references/r2-data-catalog/` |
| R2 SQL          | `references/r2-sql/`          |

### AI & Machine Learning

| Product    | Reference                |
| ---------- | ------------------------ |
| Workers AI | `references/workers-ai/` |
| Vectorize  | `references/vectorize/`  |
| Agents SDK | `references/agents-sdk/` |
| AI Gateway | `references/ai-gateway/` |
| AI Search  | `references/ai-search/`  |

### Networking & Connectivity

| Product              | Reference                          |
| -------------------- | ---------------------------------- |
| Tunnel               | `references/tunnel/`               |
| Spectrum             | `references/spectrum/`             |
| TURN                 | `references/turn/`                 |
| Network Interconnect | `references/network-interconnect/` |
| Argo Smart Routing   | `references/argo-smart-routing/`   |
| Workers VPC          | `references/workers-vpc/`          |

### Security

| Product         | Reference                    |
| --------------- | ---------------------------- |
| WAF             | `references/waf/`            |
| DDoS Protection | `references/ddos/`           |
| Bot Management  | `references/bot-management/` |
| API Shield      | `references/api-shield/`     |
| Turnstile       | `references/turnstile/`      |

### Media & Content

| Product           | Reference                       |
| ----------------- | ------------------------------- |
| Images            | `references/images/`            |
| Stream            | `references/stream/`            |
| Browser Rendering | `references/browser-rendering/` |
| Zaraz             | `references/zaraz/`             |

### Real-Time Communication

| Product      | Reference                  |
| ------------ | -------------------------- |
| RealtimeKit  | `references/realtimekit/`  |
| Realtime SFU | `references/realtime-sfu/` |

### Developer Tools

| Product            | Reference                        |
| ------------------ | -------------------------------- |
| Wrangler           | `references/wrangler/`           |
| Miniflare          | `references/miniflare/`          |
| C3                 | `references/c3/`                 |
| Observability      | `references/observability/`      |
| Analytics Engine   | `references/analytics-engine/`   |
| Web Analytics      | `references/web-analytics/`      |
| Sandbox            | `references/sandbox/`            |
| Workerd            | `references/workerd/`            |
| Workers Playground | `references/workers-playground/` |

### Infrastructure as Code

| Product   | Reference               |
| --------- | ----------------------- |
| Pulumi    | `references/pulumi/`    |
| Terraform | `references/terraform/` |
| API       | `references/api/`       |

### Other Services

| Product       | Reference                   |
| ------------- | --------------------------- |
| Email Routing | `references/email-routing/` |
| Email Workers | `references/email-workers/` |
| Static Assets | `references/static-assets/` |
| Bindings      | `references/bindings/`      |
| Cache Reserve | `references/cache-reserve/` |

## Troubleshooting

### Escalated Network Access

If deployment fails due to network issues (timeouts, DNS errors, connection resets), rerun the deploy with escalated permissions (use `sandbox_permissions=require_escalated`). The deploy requires escalated network access when sandbox networking blocks outbound requests.

Example guidance to the user:

```
The deploy needs escalated network access to deploy to Cloudflare. I can rerun the command with escalated permissions—want me to proceed?
```

© github.com/openai/skills · Apache-2.0 · tech-leads-club/agent-skills

Similar skills

All skills for DevOps and infrastructure →

From the same set130

The whole set →
security-best-practices Reviews code against security best practices for Python, JavaScript/TypeScript and Go, then suggests fixes. CX Codex +1 390installs figma-implement-design figma-implement-design converts Figma components and frames into production code with visual accuracy using the Figma MCP workflow. CX Codex +1 ★ 7,191repo stars gh-address-comments gh-address-comments finds the open pull request on your current branch, lists its review comments, and fixes the ones you pick. CX Codex +1 ★ 7,191repo stars web-design-guidelines web-design-guidelines reviews UI components against Web Interface Guidelines. Catches accessibility issues, missing form labels, and hydration pitfalls directly in your code. CX Codex +1 ★ 7,191repo stars tlc-spec-driven tlc-spec-driven guides feature development through four adaptive phases with EARS specs, automated gates, and atomic commits. Useful when you need test-backed code execution. CX Codex +1 1,300installs subagent-creator subagent-creator walks you through writing a subagent: frontmatter, prompt, steps and a report format. Useful when a task needs its own context window. CX Codex +1 956installs technical-design-doc-creator technical-design-doc-creator generates Technical Design Documents, RFCs, and architecture specs through interactive discovery before coding. Useful for aligning migrations, schemas, and team reviews. CX Codex +1 655installs domain-analysis domain-analysis walks a codebase to find subdomains and suggest where service boundaries belong. Useful before splitting a monolith. CX Codex +1 381installs

More in the catalog

Project sponsors

Companies that keep this analytics open