cloudflare-deploy

Category: Ops & Delivery | Uploader: mizchi | Downloads: 0 | Version: v1.0（Latest）

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.

Changelog: Source: GitHub https://github.com/mizchi/chezmoi-dotfiles

Directory Structure

Current level: tree/main/dot_claude/skills/cloudflare-deploy/

📁 agents/
- 📄 openai.yaml 331 B
📁 assets/
- 📄 cloudflare-small.svg 1.2 KB
- 📄 cloudflare.png 1.2 KB
📁 references/
- 📁 agents-sdk/
  - 📄 api.md 5.7 KB
  - 📄 configuration.md 3.5 KB
  - 📄 gotchas.md 5.0 KB
  - 📄 patterns.md 5.5 KB
  - 📄 README.md 2.7 KB
- 📁 ai-gateway/
  - 📄 configuration.md 2.9 KB
  - 📄 dynamic-routing.md 1.8 KB
  - 📄 features.md 2.7 KB
  - 📄 README.md 6.2 KB
  - 📄 sdk-integration.md 2.6 KB
  - 📄 troubleshooting.md 2.4 KB
- 📁 ai-search/
  - 📄 api.md 2.5 KB
  - 📄 configuration.md 1.7 KB
  - 📄 gotchas.md 2.1 KB
  - 📄 patterns.md 2.0 KB
  - 📄 README.md 4.4 KB
- 📁 analytics-engine/
  - 📄 api.md 3.1 KB
  - 📄 configuration.md 2.3 KB
  - 📄 gotchas.md 2.0 KB
  - 📄 patterns.md 2.3 KB
  - 📄 README.md 3.1 KB
- 📁 api/
  - 📄 api.md 4.2 KB
  - 📄 configuration.md 3.7 KB
  - 📄 gotchas.md 5.3 KB
  - 📄 patterns.md 4.5 KB
  - 📄 README.md 2.3 KB
- 📁 api-shield/
  - 📄 api.md 3.8 KB
  - 📄 configuration.md 4.9 KB
  - 📄 gotchas.md 4.8 KB
  - 📄 patterns.md 5.7 KB
  - 📄 README.md 1.8 KB
- 📁 argo-smart-routing/
  - 📄 api.md 6.4 KB
  - 📄 configuration.md 4.4 KB
  - 📄 gotchas.md 4.2 KB
  - 📄 patterns.md 3.0 KB
  - 📄 README.md 4.0 KB
- 📁 bindings/
  - 📄 api.md 5.1 KB
  - 📄 configuration.md 4.4 KB
  - 📄 gotchas.md 6.0 KB
  - 📄 patterns.md 4.9 KB
  - 📄 README.md 3.9 KB
- 📁 bot-management/
  - 📄 api.md 5.7 KB
  - 📄 configuration.md 5.6 KB
  - 📄 gotchas.md 5.5 KB
  - 📄 patterns.md 4.9 KB
  - 📄 README.md 3.7 KB
- 📁 browser-rendering/
  - 📄 api.md 2.9 KB
  - 📄 configuration.md 1.8 KB
  - 📄 gotchas.md 2.5 KB
  - 📄 patterns.md 2.6 KB
  - 📄 README.md 3.0 KB
- 📁 c3/
  - 📄 api.md 2.2 KB
  - 📄 configuration.md 1.6 KB
  - 📄 gotchas.md 2.3 KB
  - 📄 patterns.md 2.2 KB
  - 📄 README.md 3.3 KB
- 📁 cache-reserve/
  - 📄 api.md 5.9 KB
  - 📄 configuration.md 3.6 KB
  - 📄 gotchas.md 5.7 KB
  - 📄 patterns.md 6.1 KB
  - 📄 README.md 5.5 KB
- 📁 containers/
  - 📄 api.md 4.2 KB
  - 📄 configuration.md 5.3 KB
  - 📄 gotchas.md 4.4 KB
  - 📄 patterns.md 4.8 KB
  - 📄 README.md 3.4 KB
- 📁 cron-triggers/
  - 📄 api.md 5.7 KB
  - 📄 configuration.md 4.2 KB
  - 📄 gotchas.md 6.2 KB
  - 📄 patterns.md 6.8 KB
  - 📄 README.md 2.9 KB
- 📁 d1/
  - 📄 api.md 6.6 KB
  - 📄 configuration.md 5.3 KB
  - 📄 gotchas.md 4.2 KB
  - 📄 patterns.md 7.1 KB
  - 📄 README.md 4.6 KB
- 📁 ddos/
  - 📄 api.md 4.1 KB
  - 📄 configuration.md 2.9 KB
  - 📄 gotchas.md 3.8 KB
  - 📄 patterns.md 5.5 KB
  - 📄 README.md 2.0 KB
- 📁 do-storage/
  - 📄 api.md 3.5 KB
  - 📄 configuration.md 2.2 KB
  - 📄 gotchas.md 5.1 KB
  - 📄 patterns.md 5.2 KB
  - 📄 README.md 2.7 KB
  - 📄 testing.md 4.8 KB
- 📁 durable-objects/
  - 📄 api.md 6.0 KB
  - 📄 configuration.md 4.2 KB
  - 📄 gotchas.md 7.1 KB
  - 📄 patterns.md 6.5 KB
  - 📄 README.md 6.5 KB
- 📁 email-routing/
  - 📄 api.md 5.2 KB
  - 📄 configuration.md 3.5 KB
  - 📄 gotchas.md 4.0 KB
  - 📄 patterns.md 5.4 KB
  - 📄 README.md 3.4 KB
- 📁 email-workers/
  - 📄 api.md 5.9 KB
  - 📄 configuration.md 2.7 KB
  - 📄 gotchas.md 3.0 KB
  - 📄 patterns.md 2.7 KB
  - 📄 README.md 5.2 KB
- 📁 hyperdrive/
  - 📄 api.md 3.8 KB
  - 📄 configuration.md 3.8 KB
  - 📄 gotchas.md 3.8 KB
  - 📄 patterns.md 5.8 KB
  - 📄 README.md 2.8 KB
- 📁 images/
  - 📄 api.md 2.5 KB
  - 📄 configuration.md 4.0 KB
  - 📄 gotchas.md 2.4 KB
  - 📄 patterns.md 3.5 KB
  - 📄 README.md 2.8 KB
- 📁 kv/
  - 📄 api.md 4.2 KB
  - 📄 configuration.md 3.0 KB
  - 📄 gotchas.md 4.4 KB
  - 📄 patterns.md 4.6 KB
  - 📄 README.md 2.8 KB
- 📁 miniflare/
  - 📄 api.md 4.5 KB
  - 📄 configuration.md 3.4 KB
  - 📄 gotchas.md 3.6 KB
  - 📄 patterns.md 4.2 KB
  - 📄 README.md 2.9 KB
- 📁 network-interconnect/
  - 📄 api.md 5.5 KB
  - 📄 configuration.md 4.2 KB
  - 📄 gotchas.md 5.4 KB
  - 📄 patterns.md 3.9 KB
  - 📄 README.md 3.2 KB
- 📁 observability/
  - 📄 api.md 3.4 KB
  - 📄 configuration.md 3.5 KB
  - 📄 gotchas.md 3.7 KB
  - 📄 patterns.md 2.4 KB
  - 📄 README.md 3.8 KB
- 📁 pages/
  - 📄 api.md 5.8 KB
  - 📄 configuration.md 5.7 KB
  - 📄 gotchas.md 7.8 KB
  - 📄 patterns.md 5.9 KB
  - 📄 README.md 2.8 KB
- 📁 pages-functions/
  - 📄 api.md 4.6 KB
  - 📄 configuration.md 2.9 KB
  - 📄 gotchas.md 3.8 KB
  - 📄 patterns.md 4.1 KB
  - 📄 README.md 3.2 KB
- 📁 pipelines/
  - 📄 api.md 5.0 KB
  - 📄 configuration.md 2.7 KB
  - 📄 gotchas.md 2.4 KB
  - 📄 patterns.md 2.0 KB
  - 📄 README.md 3.3 KB
- 📁 pulumi/
  - 📄 api.md 5.6 KB
  - 📄 configuration.md 5.5 KB
  - 📄 gotchas.md 6.4 KB
  - 📄 patterns.md 6.8 KB
  - 📄 README.md 3.2 KB
- 📁 queues/
  - 📄 api.md 5.4 KB
  - 📄 configuration.md 3.7 KB
  - 📄 gotchas.md 7.1 KB
  - 📄 patterns.md 5.4 KB
  - 📄 README.md 3.0 KB
- 📁 r2/
  - 📄 api.md 5.5 KB
  - 📄 configuration.md 3.6 KB
  - 📄 gotchas.md 4.9 KB
  - 📄 patterns.md 5.7 KB
  - 📄 README.md 2.8 KB
- 📁 r2-data-catalog/
  - 📄 api.md 5.9 KB
  - 📄 configuration.md 5.2 KB
  - 📄 gotchas.md 6.0 KB
  - 📄 patterns.md 5.7 KB
  - 📄 README.md 6.9 KB
- 📁 r2-sql/
  - 📄 api.md 3.9 KB
  - 📄 configuration.md 3.7 KB
  - 📄 gotchas.md 6.1 KB
  - 📄 patterns.md 6.6 KB
  - 📄 README.md 5.1 KB
- 📁 realtime-sfu/
  - 📄 api.md 3.7 KB
  - 📄 configuration.md 3.4 KB
  - 📄 gotchas.md 4.8 KB
  - 📄 patterns.md 5.3 KB
  - 📄 README.md 3.0 KB
- 📁 realtimekit/
  - 📄 api.md 8.2 KB
  - 📄 configuration.md 5.1 KB
  - 📄 gotchas.md 6.7 KB
  - 📄 patterns.md 7.5 KB
  - 📄 README.md 4.0 KB
- 📁 sandbox/
  - 📄 api.md 4.9 KB
  - 📄 configuration.md 3.3 KB
  - 📄 gotchas.md 5.3 KB
  - 📄 patterns.md 5.1 KB
  - 📄 README.md 3.0 KB
- 📁 secrets-store/
  - 📄 api.md 4.3 KB
  - 📄 configuration.md 3.8 KB
  - 📄 gotchas.md 3.7 KB
  - 📄 patterns.md 5.5 KB
  - 📄 README.md 2.2 KB
- 📁 smart-placement/
  - 📄 api.md 5.4 KB
  - 📄 configuration.md 6.0 KB
  - 📄 gotchas.md 5.5 KB
  - 📄 patterns.md 5.6 KB
  - 📄 README.md 4.9 KB
- 📁 snippets/
  - 📄 api.md 5.0 KB
  - 📄 configuration.md 6.2 KB
  - 📄 gotchas.md 2.2 KB
  - 📄 patterns.md 3.3 KB
  - 📄 README.md 3.1 KB
- 📁 spectrum/
  - 📄 api.md 4.8 KB
  - 📄 configuration.md 4.2 KB
  - 📄 gotchas.md 3.7 KB
  - 📄 patterns.md 4.7 KB
  - 📄 README.md 2.3 KB
- 📁 static-assets/
  - 📄 api.md 4.3 KB
  - 📄 configuration.md 4.7 KB
  - 📄 gotchas.md 4.0 KB
  - 📄 patterns.md 4.8 KB
  - 📄 README.md 2.1 KB
- 📁 stream/
  - 📄 api-live.md 5.1 KB
  - 📄 api.md 5.1 KB
  - 📄 configuration.md 3.1 KB
  - 📄 gotchas.md 4.2 KB
  - 📄 patterns.md 6.2 KB
  - 📄 README.md 3.8 KB
- 📁 tail-workers/
  - 📄 api.md 5.0 KB
  - 📄 configuration.md 3.4 KB
  - 📄 gotchas.md 4.5 KB
  - 📄 patterns.md 3.9 KB
  - 📄 README.md 2.9 KB
- 📁 terraform/
  - 📄 api.md 3.9 KB
  - 📄 configuration.md 7.4 KB
  - 📄 gotchas.md 5.1 KB
  - 📄 patterns.md 6.5 KB
  - 📄 README.md 3.6 KB
- 📁 tunnel/
  - 📄 api.md 4.3 KB
  - 📄 configuration.md 3.6 KB
  - 📄 gotchas.md 3.8 KB
  - 📄 networking.md 3.9 KB
  - 📄 patterns.md 3.8 KB
  - 📄 README.md 3.7 KB
- 📁 turn/
  - 📄 api.md 5.1 KB
  - 📄 configuration.md 4.1 KB
  - 📄 gotchas.md 6.9 KB
  - 📄 patterns.md 6.0 KB
  - 📄 README.md 3.6 KB
- 📁 turnstile/
  - 📄 api.md 6.3 KB
  - 📄 configuration.md 6.6 KB
  - 📄 gotchas.md 6.1 KB
  - 📄 patterns.md 4.6 KB
  - 📄 README.md 3.5 KB
- 📁 vectorize/
  - 📄 api.md 2.3 KB
  - 📄 configuration.md 1.9 KB
  - 📄 gotchas.md 2.1 KB
  - 📄 patterns.md 2.5 KB
  - 📄 README.md 4.2 KB
- 📁 waf/
  - 📄 api.md 5.7 KB
  - 📄 configuration.md 4.7 KB
  - 📄 gotchas.md 6.1 KB
  - 📄 patterns.md 5.2 KB
  - 📄 README.md 3.4 KB
- 📁 web-analytics/
  - 📄 configuration.md 2.0 KB
  - 📄 gotchas.md 2.0 KB
  - 📄 integration.md 1.7 KB
  - 📄 patterns.md 2.2 KB
  - 📄 README.md 5.1 KB
- 📁 workerd/
  - 📄 api.md 4.8 KB
  - 📄 configuration.md 5.1 KB
  - 📄 gotchas.md 4.7 KB
  - 📄 patterns.md 4.8 KB
  - 📄 README.md 2.7 KB
- 📁 workers/
  - 📄 api.md 5.0 KB
  - 📄 configuration.md 4.3 KB
  - 📄 frameworks.md 4.2 KB
  - 📄 gotchas.md 4.6 KB
  - 📄 patterns.md 5.3 KB
  - 📄 README.md 3.4 KB
- 📁 workers-ai/
  - 📄 api.md 2.7 KB
  - 📄 configuration.md 1.9 KB
  - 📄 gotchas.md 2.6 KB
  - 📄 patterns.md 3.0 KB
  - 📄 README.md 5.9 KB
- 📁 workers-for-platforms/
  - 📄 api.md 5.4 KB
  - 📄 configuration.md 3.8 KB
  - 📄 gotchas.md 5.3 KB
  - 📄 patterns.md 5.5 KB
  - 📄 README.md 3.8 KB
- 📁 workers-playground/
  - 📄 api.md 2.2 KB
  - 📄 configuration.md 4.4 KB
  - 📄 gotchas.md 2.0 KB
  - 📄 patterns.md 3.2 KB
  - 📄 README.md 3.9 KB
- 📁 workers-vpc/
  - 📄 api.md 5.2 KB
  - 📄 configuration.md 3.8 KB
  - 📄 gotchas.md 4.4 KB
  - 📄 patterns.md 5.9 KB
  - 📄 README.md 5.4 KB
- 📁 workflows/
  - 📄 api.md 6.3 KB
  - 📄 configuration.md 3.6 KB
  - 📄 gotchas.md 4.5 KB
  - 📄 patterns.md 6.5 KB
  - 📄 README.md 2.4 KB
- 📁 wrangler/
  - 📄 api.md 4.5 KB
  - 📄 auth.md 2.1 KB
  - 📄 configuration.md 4.6 KB
  - 📄 gotchas.md 5.7 KB
  - 📄 patterns.md 4.8 KB
  - 📄 README.md 4.6 KB
- 📁 zaraz/
  - 📄 api.md 3.1 KB
  - 📄 configuration.md 1.8 KB
  - 📄 gotchas.md 2.0 KB
  - 📄 IMPLEMENTATION_SUMMARY.md 3.4 KB
  - 📄 patterns.md 2.1 KB
  - 📄 README.md 3.8 KB
📄 LICENSE.txt 10.5 KB
📄 SKILL.md 7.2 KB

SKILL.md

---
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.
---

# 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?
```

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

cloudflare-deploy

Directory Structure

SKILL.md

Report

Notice