| name | cloudflare |
| description | Index of Cloudflare-platform skills relevant to this repo. Load when
working on anything that touches Workers, Durable Objects, wrangler,
the sandbox SDK, the agents SDK, or other Cloudflare platform surface.
Triggers include "Cloudflare", "Workers", "Durable Object", "wrangler",
"KV", "R2", "D1", "Vectorize", "Containers", "sandbox".
|
Cloudflare platform skills
This repo is built on Cloudflare Workers and Durable Objects. The
authoritative platform guidance lives in the cloudflare/skills
repository rather than vendored into this repo, so it stays current.
This file is an index — open the relevant skill below when its trigger
applies and read its SKILL.md before starting work.
If a skill isn't already available in your environment, fetch it from
the URL listed and load it manually. The fallback for everything is
the official Cloudflare documentation at
https://developers.cloudflare.com.
Primary skills
These three cover almost every change in this repo:
| Skill | Load when |
|---|
durable-objects | Writing or reviewing Durable Object code: RPC methods, SQLite storage, alarms, WebSockets, hibernation. Most work in packages/dofs and packages/workspace qualifies. |
workers-best-practices | Writing or reviewing Worker code: streaming, floating promises, global state, bindings, secrets, observability, wrangler.jsonc configuration. |
agents-sdk | Building on the Cloudflare Agents SDK: stateful agents, Workflows integration, scheduled tasks, MCP servers. Relevant to examples/think. |
Other skills
Load these when their trigger applies:
| Skill | Load when |
|---|
wrangler | Running wrangler commands: deploy, dev, secrets, bindings for KV, R2, D1, Vectorize, Hyperdrive, Queues, Workflows, Containers. |
cloudflare | General Cloudflare platform questions outside the more specific skills above — KV, R2, D1, Vectorize, networking, security, infrastructure-as-code. |
sandbox-sdk | Building or reviewing sandboxed-execution code paths. Relevant to examples/container and to the wsd container model in general. |
web-perf | Profiling page load, Core Web Vitals, or render-blocking issues. Rarely relevant in this repo, but listed for completeness. |
cloudflare-email-service | Working with Cloudflare Email Routing or the Email Workers binding. Not currently used in this repo. |
How this maps to the repo
packages/dofs is a Durable Object with SQLite storage. Load
durable-objects
before changing storage shape, RPC methods, or alarm handling.
Load workers-best-practices
for the surrounding Worker glue.packages/workspace runs inside the Durable Object and
exposes the capnweb WorkspaceRPC to wsd. Load
durable-objects
for the hosting model and the capnweb
skill for the RPC surface itself.packages/wsd runs in a sandbox container, not in a Worker.
Load sandbox-sdk
if you're working on the container boundary; the FUSE and
HTTP/WebSocket internals are local to the package.examples/think is an agent. Load
agents-sdk
when changing it.- Deploys, secrets, bindings. Load
wrangler
before running wrangler commands or editing wrangler.jsonc.
When to escalate
If you're about to write something that crosses two Cloudflare
surfaces — say, a Worker that wakes a Durable Object that talks to a
container — load both relevant skills before starting. The skills are
small; loading two is cheaper than fixing an architectural mistake.
