AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

cloudflare-deploy

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.

Original source
openai
License
Apache-2.0
Pinned revision
49f948faa9258a0c61caceaf225e179651397431

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read openai--cloudflare-deploy at revision 49f948faa9258a0c61caceaf225e179651397431, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 309

references/snippets/gotchas.md

Gotchas & Best Practices

Common Errors

1000: "Snippet execution failed"

Runtime error or syntax error. Wrap code in try/catch:

try { return await fetch(request); }
catch (error) { return new Response(`Error: ${error.message}`, { status: 500 }); }

1100: "Exceeded execution limit"

Code takes >5ms CPU. Simplify logic or move to Workers.

1201: "Multiple origin fetches"

Call fetch(request) exactly once:

// ❌ Multiple origin fetches
const r1 = await fetch(request); const r2 = await fetch(request);
// ✅ Single fetch, reuse response
const response = await fetch(request);

1202: "Subrequest limit exceeded"

Pro: 2 subrequests, Business/Enterprise: 5. Reduce fetch calls.

"Cannot set property on immutable object"

Clone before modifying:

const modifiedRequest = new Request(request);
modifiedRequest.headers.set("X-Custom", "value");

"caches is not defined"

Cache API NOT available in Snippets. Use Workers.

"Module not found"

Snippets don't support import. Use inline code or Workers.

Best Practices

Performance

  • Keep code <10KB (32KB limit)
  • Optimize for 5ms CPU
  • Clone only when modifying
  • Minimize subrequests

Security

  • Validate all inputs
  • Use Web Crypto API for hashing
  • Sanitize headers before origin
  • Don't log secrets

Debugging

newResponse.headers.set("X-Debug-Country", request.cf.country);
curl -H "X-Test: true" https://example.com -v

Available APIs

✅ Available: fetch(), Request, Response, Headers, URL, crypto.subtle, crypto.randomUUID(), atob()/btoa(), JSON

❌ NOT Available: caches, KV, D1, R2, Durable Objects, WebSocket, HTMLRewriter, import, Node.js APIs

Limits

| Resource | Limit | |----------|-------| | Snippet size | 32KB | | Execution time | 5ms CPU | | Subrequests (Pro/Biz) | 2/5 | | Snippets/zone | 20 |

Performance Benchmarks

| Operation | Time | |-----------|------| | Header set | <0.1ms | | URL parsing | <0.2ms | | fetch() | 1-3ms | | SHA-256 | 0.5-1ms |

Migrate to Workers when: >5ms needed, >5 subrequests, need storage (KV/D1/R2), need npm packages, >32KB code