durable-objects

An agent skill by cloudflare, from cloudflare/skills. Tags: cloudflare, debugging, state-management, storage, workers.

What it does

Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add cloudflare/skills --skill durable-objects

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/cloudflare/skills
cp -r skills/skills/durable-objects ~/.claude/skills/durable-objects

Safety box score

Grade C, moderate risk: 37 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.

This skill is documentation for building and reviewing Cloudflare Durable Objects apps; it does not ship executable code, but it does point the agent at Cloudflare tooling and account-affecting commands. The main risks are publishing changes with Wrangler, managing secrets in Cloudflare, and forwarding logs or other data over the network.

Category levels, from 0 (none) to 3 (high)
Category	Level	Why
Code & shell execution	1 (low)	No bundled scripts or binaries are shipped, but the markdown includes runnable commands like `wrangler dev`, `wrangler deploy`, and `wrangler secret put`.
Network access	2 (moderate)	It explicitly tells the agent to fetch remote docs from Cloudflare URLs and includes Cloudflare-facing operations such as `wrangler tail` and `wrangler deploy`, which send data over the network.
Filesystem reach	1 (low)	The skill focuses edits on project files such as `wrangler.jsonc`, `wrangler.toml`, `src/index.ts`, and test files; it does not direct writes outside the workspace.
Secrets & credentials	2 (moderate)	It documents secret handling with `wrangler secret put API_KEY` and `wrangler secret put DATABASE_URL`, and code access via `env.API_KEY`, which touches account secrets.
Privilege & persistence	1 (low)	There is no sudo or OS-level privilege use, but it does instruct account-level configuration changes in Wrangler such as secrets and deployment settings.
Instruction hijack surface	0 (none)	I found no instructions to ignore agent rules, hide behavior, follow untrusted remote instructions, or use hidden prompt text.
Irreversible actions	2 (moderate)	The included `wrangler deploy` command can publish code to Cloudflare, and the examples also perform external actions like sending messages through Durable Object methods.
Transparency	0 (none)	All files are plain markdown and readable; there are no binaries, generated blobs, or decoded-at-runtime code.

Before installing

Read `references/workers.md` for the `wrangler deploy` and `wrangler secret put` commands.
Check whether your workflow allows the agent to change Cloudflare secrets and deployment settings.
Run it first in a scratch Cloudflare project/account if you do not want live deployment or logging changes.
Verify whether your repo already uses Tail Workers or other log forwarding before letting the agent modify config.

Rated 2026-10-20 by an automated review of 4 files from the skill's repository.

Source

Repository: cloudflare/skills (all skills from this repository)
Path: skills/durable-objects/SKILL.md
Branch: main
Updated: 2026-09-20

eas-hosting — EAS service (paid). Deploy Expo websites and Expo Router API routes to EAS Hosting - export the web bundle, run eas deploy for production and PR preview URLs.
agents-sdk — Build, debug, or review Cloudflare Agents SDK applications using the agents package.
sandbox-next — Build or maintain Cloudflare Sandbox apps on @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-migrate-to-next when porting a stable app.
sandbox-stable — Build or maintain Cloudflare Sandbox apps on the stable @cloudflare/sandbox package.
workers-best-practices — Cloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers.
wrangler — Run or troubleshoot Wrangler CLI commands and configure Worker projects for local development, deployment, and Cloudflare resource management.