cloudflare

Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task. references: - workers - pages - d1 - durable-objects - workers-ai

npx skills add https://github.com/cloudflare/skills --skill cloudflare

Cloudflare Platform Skill

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

Your knowledge of Cloudflare APIs, types, limits, and pricing may be outdated. Prefer retrieval over pre-training — the references in this skill are starting points, not source of truth.

Retrieval Sources

Fetch the latest information before citing specific numbers, API signatures, or configuration options. Do not rely on baked-in knowledge or these reference files alone.

SourceHow to retrieveUse for
Cloudflare docscloudflare-docs search tool or https://developers.cloudflare.com/Limits, pricing, API reference, compatibility dates/flags
Workers typesnpm pack @cloudflare/workers-types or check node_modulesType signatures, binding shapes, handler types
Wrangler config schemanode_modules/wrangler/config-schema.jsonConfig fields, binding shapes, allowed values
Product changelogshttps://developers.cloudflare.com/changelog/Recent changes to limits, features, deprecations

When a reference file and the docs disagree, trust the docs. This is especially important for: numeric limits, pricing tiers, type signatures, and configuration options.

Quick Decision Trees

"I need feature flags"

Need feature flags?
└─ Feature toggles, targeting rules, percentage rollouts → flagship/
   ├─ Evaluate in Workers → Flagship binding (env.FLAGS)
   ├─ Evaluate in Node.js / browser → OpenFeature SDK (@cloudflare/flagship)
   └─ Manage flags via API → Flagship REST API

"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/
├─ Versioned file trees (repos, build outputs, checkpoints) → artifacts/
├─ 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 analytics/metrics data"

Need analytics?
├─ Query across all Cloudflare products (HTTP, Workers, DNS, etc.) → graphql-api/
├─ Custom high-cardinality metrics from Workers → analytics-engine/
├─ Client-side (RUM) performance data → web-analytics/
├─ Workers Logs and real-time debugging → observability/
└─ Raw logs (Logpush to external tools) → Cloudflare docs

"I need infrastructure-as-code"

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

Product Index

Feature Flags

ProductReference
Flagshipreferences/flagship/

Compute & Runtime

ProductReference
Workersreferences/workers/
Pagesreferences/pages/
Pages Functionsreferences/pages-functions/
Durable Objectsreferences/durable-objects/
Workflowsreferences/workflows/
Containersreferences/containers/
Workers for Platformsreferences/workers-for-platforms/
Cron Triggersreferences/cron-triggers/
Tail Workersreferences/tail-workers/
Snippetsreferences/snippets/
Smart Placementreferences/smart-placement/

Storage & Data

ProductReference
KVreferences/kv/
D1references/d1/
R2references/r2/
Artifactsreferences/artifacts/
Queuesreferences/queues/
Hyperdrivereferences/hyperdrive/
DO Storagereferences/do-storage/
Secrets Storereferences/secrets-store/
Pipelinesreferences/pipelines/
R2 Data Catalogreferences/r2-data-catalog/
R2 SQLreferences/r2-sql/

AI & Machine Learning

ProductReference
Workers AIreferences/workers-ai/
Vectorizereferences/vectorize/
Agents SDKreferences/agents-sdk/
AI Gatewayreferences/ai-gateway/
AI Searchreferences/ai-search/

Networking & Connectivity

ProductReference
Tunnelreferences/tunnel/
Spectrumreferences/spectrum/
TURNreferences/turn/
Network Interconnectreferences/network-interconnect/
Argo Smart Routingreferences/argo-smart-routing/
Workers VPCreferences/workers-vpc/

Security

ProductReference
WAFreferences/waf/
DDoS Protectionreferences/ddos/
Bot Managementreferences/bot-management/
API Shieldreferences/api-shield/
Turnstilereferences/turnstile/

Media & Content

ProductReference
Imagesreferences/images/
Streamreferences/stream/
Browser Renderingreferences/browser-rendering/
Zarazreferences/zaraz/

Real-Time Communication

ProductReference
RealtimeKitreferences/realtimekit/
Realtime SFUreferences/realtime-sfu/

Developer Tools

ProductReference
Wranglerreferences/wrangler/
Miniflarereferences/miniflare/
C3references/c3/
Observabilityreferences/observability/
GraphQL Analytics APIreferences/graphql-api/
Analytics Enginereferences/analytics-engine/
Web Analyticsreferences/web-analytics/
Sandboxreferences/sandbox/
Workerdreferences/workerd/
Workers Playgroundreferences/workers-playground/

Infrastructure as Code

ProductReference
Pulumireferences/pulumi/
Terraformreferences/terraform/
APIreferences/api/

Other Services

ProductReference
Email Routingreferences/email-routing/
Email Workersreferences/email-workers/
Static Assetsreferences/static-assets/
Bindingsreferences/bindings/
Cache Reservereferences/cache-reserve/

Thêm skills từ Cloudflare

agents-sdk
Cloudflare
Xây dựng AI agent trên Cloudflare Workers bằng Agents SDK. Tải khi tạo agent có trạng thái, quy trình làm việc bền vững, ứng dụng WebSocket thời gian thực, tác vụ theo lịch, máy chủ MCP hoặc ứng dụng trò chuyện. Bao gồm lớp Agent, quản lý trạng thái, RPC có thể gọi, tích hợp Workflows và React hooks.
official
building-ai-agent-on-cloudflare
Cloudflare
| Xây dựng các tác tử AI trên Cloudflare bằng Agents SDK với quản lý trạng thái, WebSocket thời gian thực, tác vụ theo lịch, tích hợp công cụ và khả năng trò chuyện. Tạo mã tác tử sẵn sàng cho production được triển khai lên Workers. Sử dụng khi: người dùng muốn "xây dựng tác tử", "tác tử AI", "tác tử trò chuyện", "tác tử có trạng thái", đề cập đến "Agents SDK", cần "AI thời gian thực", "WebSocket AI", hoặc hỏi về "quản lý trạng thái" tác tử, "tác vụ theo lịch" hoặc "gọi công cụ".
developmentofficial
building-mcp-server-on-cloudflare
Cloudflare
| Xây dựng máy chủ MCP (Model Context Protocol) từ xa trên Cloudflare Workers với các công cụ, xác thực OAuth và triển khai sản xuất. Tạo mã máy chủ, cấu hình nhà cung cấp xác thực và triển khai lên Workers. Sử dụng khi: người dùng muốn "xây dựng máy chủ MCP", "tạo công cụ MCP", "MCP từ xa", "triển khai MCP", thêm "OAuth vào MCP" hoặc đề cập đến Model Context Protocol trên Cloudflare. Cũng kích hoạt khi có "xác thực MCP" hoặc "triển khai MCP".
developmentofficial
durable-objects
Cloudflare
Tạo và xem xét Cloudflare Durable Objects. Sử dụng khi xây dựng phối hợp có trạng thái (phòng chat, trò chơi nhiều người chơi, hệ thống đặt chỗ), triển khai phương thức RPC, lưu trữ SQLite, báo thức, WebSockets, hoặc xem xét mã DO để áp dụng các phương pháp tốt nhất. Bao gồm tích hợp Workers, cấu hình wrangler và kiểm thử với Vitest.
official
sandbox-sdk
Cloudflare
Xây dựng các ứng dụng sandbox để thực thi mã an toàn. Tải khi xây dựng hệ thống thực thi mã AI, trình thông dịch mã, hệ thống CI/CD, môi trường phát triển tương tác hoặc thực thi mã không đáng tin cậy. Bao gồm vòng đời Sandbox SDK, lệnh, tệp, trình thông dịch mã và URL xem trước.
official
web-perf
Cloudflare
Phân tích hiệu suất web bằng Chrome DevTools MCP. Đo lường Core Web Vitals (FCP, LCP, TBT, CLS, Speed Index), xác định tài nguyên chặn hiển thị, chuỗi phụ thuộc mạng, thay đổi bố cục, vấn đề bộ nhớ đệm và lỗ hổng khả năng tiếp cận. Sử dụng khi được yêu cầu kiểm tra, lập hồ sơ, gỡ lỗi hoặc tối ưu hóa hiệu suất tải trang, điểm Lighthouse hoặc tốc độ trang web.
official
workers-best-practices
Cloudflare
Xem xét và tác giả mã Cloudflare Workers theo các phương pháp thực hành tốt nhất cho sản xuất. Tải khi viết Workers mới, xem xét mã Worker, cấu hình wrangler.jsonc, hoặc kiểm tra các phản mẫu Workers phổ biến (streaming, floating promises, global state, secrets, bindings, observability). Ưu tiên truy xuất từ tài liệu Cloudflare hơn kiến thức được huấn luyện trước.
official
wrangler
Cloudflare
CLI của Cloudflare Workers để triển khai, phát triển và quản lý Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines và Secrets Store. Tải trước khi chạy các lệnh wrangler để đảm bảo cú pháp chính xác và các phương pháp tốt nhất.
official