skilld
All skills
openai avatar

/cloudflare-deploy

@bf9e226 official
by openaiopenai/skills28k stars
1,891

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/openai/skills/cloudflare-deploy

This session only. Nothing lands on disk.

referencesc3gotchas.md

≈577 tokens on demand. Your agent reads this file only when SKILL.md points to it.

C3 Troubleshooting

Deployment Issues

Placeholder IDs

Error: "Invalid namespace ID"
Fix: Replace placeholders in wrangler.jsonc with real IDs:

npx wrangler kv namespace create MY_KV  # Get real ID

Authentication

Error: "Not authenticated"
Fix: npx wrangler login or set CLOUDFLARE_API_TOKEN

Name Conflict

Error: "Worker already exists"
Fix: Change name in wrangler.jsonc

Platform Selection

Need Platform
Git integration, branch previews --platform=pages
Durable Objects, D1, Queues Workers (default)

Wrong platform? Recreate with correct --platform flag.

TypeScript Issues

"Cannot find name 'KVNamespace'"

npm run cf-typegen  # Regenerate types
# Restart TS server in editor

Missing types after config change: Re-run npm run cf-typegen

Package Manager

Multiple lockfiles causing issues:

rm pnpm-lock.yaml  # If using npm
rm package-lock.json  # If using pnpm

CI/CD

CI hangs on prompts:

npm create cloudflare@latest my-app -- \
  --type=hello-world --lang=ts --no-git --no-deploy

Auth in CI:

env:
  CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
  CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

Framework-Specific

Framework Issue Fix
Next.js create-next-app failed npm cache clean --force, retry
Astro Adapter missing Install @astrojs/cloudflare
Remix Module errors Update @remix-run/cloudflare*

Compatibility Date

"Feature X requires compatibility_date >= ..."
Fix: Update compatibility_date in wrangler.jsonc to today's date

Node.js Version

"Node.js version not supported"
Fix: Install Node.js 18+ (nvm install 20)

Quick Reference

Error Cause Fix
Invalid namespace ID Placeholder binding Create resource, update config
Not authenticated No login npx wrangler login
Cannot find KVNamespace Missing types npm run cf-typegen
Worker already exists Name conflict Change name
CI hangs Missing flags Add --type, --lang, --no-deploy
Template not found Bad name Check cloudflare/templates

Source: SKILL.md on GitHub

Third-party checks

2 warnings17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    This skill provides comprehensive guidance for deploying and managing infrastructure on the Cloudflare platform. It includes extensive educational material on secure development practices, such as preventing SQL injection and managing secrets effectively. No malicious patterns or security risks were identified.

  • Socket17d

    2 alerts: gptAnomaly

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer7mo

    310/310 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at bf9e226. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 8 months ago

Topics

README badge

README badge for openai/skills/cloudflare-deploy

What it does

Deploys applications and infrastructure to Cloudflare's platform, including Workers, Pages, D1, R2, Durable Objects, KV, and other services. Use decision trees to route to the right Cloudflare product based on compute, storage, AI, networking, security, or media needs.

Generated from the current SKILL.md.

Frequently asked

Does this skill cover all Cloudflare products?
The skill is a consolidated index covering compute, storage, AI, networking, security, media, and developer tools on Cloudflare. It uses decision trees to route you to the right product reference, then loads detailed guidance for that product.
What authentication is required before deploying?
Run `npx wrangler whoami` to check if authenticated. For local deployment, use `wrangler login` (one-time OAuth). For CI/CD, set the `CLOUDFLARE_API_TOKEN` environment variable.
What should I do if deployment fails due to network issues?
Rerun the deploy with `sandbox_permissions=require_escalated` to grant elevated network access, which is required for outbound requests to Cloudflare during deployment.
How long does a Cloudflare deployment typically take?
Deployments may take several minutes. Use appropriate timeout values in your configuration or CI/CD environment.

Generated from the current SKILL.md. These answers refresh after source changes.