← Explore all skills

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.

Upstream setup instructions ↗

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
  1. Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
  2. 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.

  1. https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/SKILL.md

    Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access

  2. https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/references/rules.md

    Supports: review, limitations, access

  3. https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/references/testing.md

    Supports: review, limitations, access

  4. https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE

    Supports: license

  5. https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md

    Supports: install, compatibility, access

  6. https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/README.md

    Supports: install

  7. https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/git.ts

    Supports: install

  8. https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/durable-objects/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

Evidence & Ask