CLOUD DEVELOPMENT / Cloudflare
Cloudflare Durable Objects
Designs per-entity state and coordination with explicit persistence, concurrency and runtime-test guidance.
“Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination.”
01 / THE REASONING
Why this made the selection.
- Defines where Durable Objects fit and where stateless Workers or independent requests fit better.
- The testing reference distinguishes repeat calls from actual persistence recovery and asks for independent object identities.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/durable-objects/SKILL.md
- skills/durable-objects/references/rules.md
- skills/durable-objects/references/testing.md
- LICENSE
- skills/durable-objects/SKILL.md, references/rules.md and references/testing.md compared with the previous review revision b052c32b: links moved to index.md pages, and SKILL.md gained an Authorization section.
Our findings
- The rules require persisting important state before relying on memory and warn against holding initialization locks over external I/O.
- The guide explains that setting a new alarm replaces the previous scheduled alarm for that object.
- The testing reference requires checking installed integration/isolation behavior before changing an existing suite.
- A new Authorization section says Durable Objects have no separate roles or permissions, so access follows the Worker that implements them, and asks the agent to scope the Workers role before granting observability or Data Studio access.
Not established by this review
- Source inspection only; no skill installation or workflow execution was performed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add cloudflare/skills/skills/durable-objects Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/cloudflare/skills/tree/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects - Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
- Choose your AI tools and project or global scope in the installer, then review its permissions before using the skill.
Before you start
- Node.js/npm for this installer
- An agent that supports the Agent Skills format
- Bindings, migrations and a matching configured runtime
- A Cloudflare account for deployed resource testing
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/references/rules.md
Supports: review, limitations, access
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/references/testing.md
Supports: review, limitations, access
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE
Supports: license
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md
Supports: install, compatibility, access
https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/git.ts
Supports: install
https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt