Cloudflare 把產品文件整理成 agent 可讀的 SKILL.md。
Cloudflare 邊緣網路涵蓋 Workers、Pages、D1、R2、KV、Vectorize、Durable Objects、Queues、Hyperdrive、Email Routing、Browser Rendering 等產品，大部分 agent 依賴訓練資料中的舊版文件推測 binding 名稱與 wrangler 旗標。cloudflare/skills 由 Cloudflare 官方寫成 8 個 SKILL.md，將建置方式整理為 agent 可讀的指令集，不需要 agent 自行解讀人類文件。
它的組織方式很單純:skills/ 下面 8 個 sub-skill(agents-sdk、cloudflare、cloudflare-email-service、durable-objects、sandbox-sdk、web-perf、workers-best-practices、wrangler),每個都是一份 SKILL.md 加上 references/ 子資料夾;最大那個 skills/cloudflare/references/ 裡有 60+ 份 reference,從 workers、workers-ai、d1、r2 一路到 turnstile、zaraz、terraform、pulumi 全收齊。
它還附 commands/build-agent.md 與 commands/build-mcp.md 兩條 slash command，加上 5 個 MCP Server（cloudflare-api、cloudflare-docs、cloudflare-bindings、cloudflare-builds、cloudflare-observability）。三個層次合起來，agent 可在同一個會話內存取 Cloudflare 文件、產品 API、部署觀察，確認應使用哪一條 binding、哪一條 wrangler 指令、哪一份 reference，而不依賴訓練資料中的過時資訊。
/plugin install
Agent 讀 SKILL.md
挑 reference
寫 wrangler.toml
wrangler deploy
MCP 觀察結果
Skills for teaching agents how to build on Cloudflare.
四種 agent 的安裝方式與指令。
環境需要 一個支援 Agent Skills 的 agent 與 Cloudflare 帳號。Claude Code、Cursor、Codex、OpenCode、Pi 均有官方支援。Claude Code 透過 plugin 指令安裝，後續 Cloudflare 更新會自動同步。
# 在 Claude Code 對話裡輸入,兩條一組
/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflareCursor / Codex / OpenCode / Pi 也能裝
Skill 是跨 agent 的標準格式,Cloudflare 在 README 直接列了五種裝法。你只要選你日常在用的 agent,裝完之後它就會「自然」理解 Cloudflare 產品。
# OpenCode / Codex / Pi 都走 npx skills add
npx skills add https://github.com/cloudflare/skills
# Cursor 走 Cursor Marketplace 一鍵裝
# https://cursor.com/marketplace → 搜尋 cloudflare不裝外掛?直接把資料夾 copy 進去
若 agent 尚未接入 plugin marketplace，Cloudflare 支援手動安裝：clone repo 後，依 README 對應表將 skills/ 與 commands/ 兩個資料夾複製到 agent 目錄（Claude Code 為 ~/.claude/skills/，OpenCode 為 ~/.config/opencode/skills/）。
git clone https://github.com/cloudflare/skills
# 依 README 的對應表把 skills/ 與 commands/ 複製到 agent 目錄三層結構：skill、command、 MCP Server 各自的職責。
repo 分三層:skills/ 8 個 SKILL.md(垂直能力)、commands/ 2 條 slash command(端到端流程)、mcp-servers/ 5 個 MCP Server(讓 agent 即時讀 Cloudflare 後台)。下面 12 張卡片把三層核心入口排出來。
Skill · 01
agents-sdk
Agent 骨架
教 agent 用 Cloudflare Agents SDK 蓋 stateful、可排程、可串接 MCP 的 Workers agent;含 Durable Object 與 Tool 用法。
Skill · 02
cloudflare
主百科
SKILL.md 主檔，下含 60+ 份 reference，涵蓋 workers、workers-ai、d1、r2 至 turnstile、zaraz、terraform、pulumi。
Skill · 03
durable-objects
狀態底座
教 agent 用 Durable Object 處理「同一個 user / room / job」的狀態與排程,以及 SQL storage、alarms、WebSocket hibernation。
Skill · 04
workers-best-practices
寫法守則
規範 Worker 的 module 風格、binding 命名、Promise 安全、cron trigger 與 rate-limit 寫法，使 agent 不產出舊式 service worker 格式。
Skill · 05
wrangler
部署規則書
wrangler.toml 的 binding 設定、env、preview、deploy、tail、log;agent 不再亂改 config 把生產跑壞。
Skill · 06
cloudflare-email-service
收與發信
規範 Email Workers 與 Email Routing 的寫法，讓 agent 產出的 email 工作流支援 inbound 解析、outbound 發信及 DMARC 配置。
Skill · 07
sandbox-sdk
隔離沙箱
教 agent 用 Cloudflare Sandbox 跑 user-generated code:檔案系統、process、network 都受控的執行環境。
Skill · 08
web-perf
效能守門
Web 效能優化規則:cache、static asset、Workers AI inference latency、Core Web Vitals 的實作守則。
Command · 09
/cloudflare:build-agent
蓋整隻 agent
一條 slash command 串起 agents-sdk + durable-objects + wrangler,從 spec 走到 wrangler deploy,適合「我要一個 customer support agent」這種任務。
Command · 10
/cloudflare:build-mcp
蓋整隻 MCP
封裝 Workers + MCP 標準的端到端流程，將現有服務轉為 agent 可掛載的 MCP Server，Claude / Cursor 均支援。
MCP · 11
cloudflare-api · -docs · -bindings
即時查 Cloudflare
三個 MCP Server，使 agent 在會話中直接查詢 Cloudflare API、官方文件與 binding 設定，不依賴訓練資料推斷。
MCP · 12
cloudflare-builds · -observability
build 與觀察
看 Workers build log、tail、observability 指標。Agent 部署完不只「丟一行 deploy 成功」,還能回頭看實際狀況。
你想蓋什麼,用哪一塊?
| 情境 | 該叫的 skill / command | 同時帶上的 MCP |
|---|---|---|
| 從零蓋一隻 stateful agent | /cloudflare:build-agent + agents-sdk | cloudflare-api · cloudflare-bindings |
| 把自家 SaaS 包成 MCP Server | /cloudflare:build-mcp | cloudflare-api · cloudflare-docs |
| 需要 per-room / per-user 狀態 | durable-objects | cloudflare-bindings |
| email 自動回覆 / 解析 | cloudflare-email-service | cloudflare-api |
| 跑 user 提交的程式碼 | sandbox-sdk | cloudflare-bindings |
| 檢查 Worker 寫法是否合規 | workers-best-practices + wrangler | cloudflare-builds · cloudflare-observability |
| 不知道某產品該怎麼用 | cloudflare + 對應 references | cloudflare-docs |
安裝後容易忽略的六個配置要點。
以下六點均依據 README 與 skills/ 目錄結構，列出安裝後容易忽略、但對 agent 輸出品質影響最大的配置細節。
build-agent 與 build-mcp 都先跑一次
/cloudflare:build-agent 與 /cloudflare:build-mcp 是 Cloudflare 親自寫的「最短路徑」。第一次蓋 agent 或 MCP server 時讓 command 帶你走完一輪,後續客製只要改 wrangler.toml 與 SKILL.md,而不是從 zero 自己拼。
來源 · README · Slash commands
cloudflare-docs MCP 是「真實版」
agent 訓練資料中的 Cloudflare 文件多半過時。cloudflare-docs MCP 在 runtime 直接取得最新文件，對 Workflows、Realtime SFU、Pipelines、Containers 等新產品的寫法尤為重要。遇到新產品，應使用 MCP 查詢，而非依賴訓練記憶。
來源 · README · MCP Servers
references/ 比 SKILL.md 還重要
skills/cloudflare/references/ 下有 60+ 份產品 reference，涵蓋 workers、workers-ai、d1、r2、vectorize、hyperdrive、queues 等，agent 依任務動態載入。若輸出有誤，可明確指定「請查閱 references/<產品名>」來修正大部分的錯誤。
來源 · skills/cloudflare/references/
agents-sdk + durable-objects 是同一條線
蓋 agent 時 agents-sdk 寫骨架、durable-objects 處理「每個 user / room / job」的狀態。兩個 skill 一起裝,agent 才會把 stateful 部分自然落到 Durable Object 上,而不是亂塞 KV。
來源 · skills/agents-sdk · skills/durable-objects
wrangler skill 鎖住 binding 命名
agent 最常出錯的是 wrangler.toml 的 binding 命名，D1、KV、R2、Queue、Vectorize 各有不同規則。wrangler skill 將命名規則寫入，agent 不會產出 my_db_database 這類混淆 name 與 type 的寫法。
來源 · skills/wrangler
observability MCP 是 deploy 後的耳朵
cloudflare-observability 使 agent 在 deploy 後自行查看 tail、log、build 結果，發現問題可直接繼續修正，不需人工進入 dashboard。對 CI 或夜間自動部署的 agent 尤為適用。
來源 · MCP · cloudflare-observability
以 Slack support agent 為例：從意圖到 wrangler deploy。
假設你要蓋一隻 Slack 客服 agent:會記住每個 channel 的對話狀態、把 KB 文章索引到 Vectorize、客戶 email 進來會自動回覆。下面是真實情境改寫,跑在已經裝好 cloudflare/skills、登入 Cloudflare 帳號的 Mac 上。一句意圖,五個 skill 接力,直接上 production。
$ You ›
幫我蓋一個 Slack 客服 agent,記住對話、能查 KB、email 進來自動回覆
> [1/5 · agents-sdk]
產出 src/index.ts · Agent class · onMessage hook
> [2/5 · durable-objects]
SupportRoom Durable Object · per-channel state
hl: → SQL storage 存歷史 · alarm 每天結 summary
> [3/5 · cloudflare/references/vectorize]
建 KB index · 把 docs/ 切 chunk 上傳
top-k 檢索接到 onMessage 流程
> [4/5 · cloudflare-email-service]
Email Worker 收件 · 路由到 SupportRoom
ok: → outbound 回覆走 send_email binding
> [5/5 · wrangler]
產 wrangler.toml · DO / Vectorize / Email 三種 binding
hl: → wrangler deploy
ok: 完成 · Worker live · DO + Vectorize + Email 已綁定
五個 skill，一條意圖，agent 依序產出 Agent class、Durable Object、Vectorize 索引、Email Worker，最後執行 wrangler deploy。
這條流程值得拆解的點
**SKILL.md 將官方規則寫入 agent。**不需在 prompt 中額外指定「使用 Durable Object 而非 KV」，durable-objects skill 已包含判斷邏輯，agent 遇到「per-room state」會自動選用正確的方式。
**references/ 是動態載入的。**沒蓋到 Vectorize 之前,agent 不會把那 60+ 份 reference 全塞進 context。skills/cloudflare SKILL.md 控制按需載入,context window 不會爆。
MCP 延伸至 deploy 後的觀察。cloudflare-observability 使 agent 在 deploy 完成後檢查 tail，確認 30 秒內無錯誤再回報完成。若有失敗，agent 會繼續修正，而非僅輸出「已部署」。
cloudflare/skills 的適用範圍與限制。
五種延伸用法與延伸閱讀清單。
cloudflare/skills 採 Apache-2.0 授權，可以 fork 後修改為公司內部的 Cloudflare skill 包，加入自家 binding 命名規則、wrangler 樣板與 reference，使團隊所有 agent 遵循同一套規範。
進階玩法地圖
**1. fork 成公司內部 skill 包。**把 skills/cloudflare 複製一份成 skills/,加上自家 binding 命名規則、自家 monitoring 規則、自家 cost guardrail。團隊新人 agent 裝完就懂規矩。
2. 把 references/ 接進文件站。skills/cloudflare/references/ 的 60+ 份 markdown 可同時供 agent 與內部文件站使用，一份原始檔服務兩種讀者：agent 與工程師。
3. 用 build-mcp 把 SaaS 變成 MCP Server。/cloudflare:build-mcp 是 Cloudflare 官方寫的「我有 API,我要變成 MCP Server」最短路徑。把現有 Workers / Hono / Express API 一鍵變 MCP,接到 Claude / Cursor / OpenCode。
**4. 接 agents-sdk 蓋客戶專屬 agent。**每個客戶一個 Durable Object，各自的 Vectorize index 與 KB。agents-sdk 與 durable-objects 兩個 skill 組合即可實現 multi-tenant agent 架構。
**5. 把 build-agent 包進 CI / 內部平台。**slash command 是 markdown,所以可以再包一層 internal CLI,做成「公司同仁打 internal create-agent,後面跑 /cloudflare:build-agent + 公司範本」。一條指令蓋一隻新 agent。
最該讀的三份延伸閱讀
① cloudflare/skills · README：五種 agent 安裝路徑及所有 skill / command / MCP 的完整清單。 ② developers.cloudflare.com/agents/：Cloudflare Agents SDK 官方文件，build-agent 的完整能力說明。 ③ Cloudflare · Model Context Protocol：Workers 轉為 MCP Server 的完整指南，build-mcp 的對應官方說明。
Cloudflare 以官方身份將產品規則寫入 SKILL.md，agent 依此產出的配置符合官方建議，而非依賴訓練資料推斷。