durable-objects

Design and review Cloudflare Durable Objects for stateful edge coordination.

1|Updated May 27, 2026
One-click install
npx skills add https://github.com/mi179/claude-skills --skill durable-objects-mi179
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: durable-objects
Source: https://github.com/mi179/claude-skills/tree/main/user/durable-objects
Command: npx skills add https://github.com/mi179/claude-skills --skill durable-objects-mi179

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps developers design and review Durable Objects for stateful coordination on Cloudflare's edge. The guidance consolidates best practices for architectural patterns, storage strategies, and deployment considerations to reduce misconfigurations and guardrails gaps.

Core Features & Use Cases

  • One DO per coordination atom to ensure strong isolation and predictable routing for chat rooms, games, bookings, or per-user work streams.
  • Guidance on storage and migrations using SQLite, wrangler configuration, and per-DO lifecycle initialization.
  • RPC-oriented design patterns, testing approaches (Vitest), observability, and error handling for robust edge services.

Quick Start

Clone this repository and review the Durable Objects references to begin implementing stateful edge patterns.

Frequently Asked Questions about durable-objects

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design Durable Objects for stateful coordination on Cloudflare's edge?

Design Durable Objects by isolating one object per coordination atom, such as a chat room or booking system, to ensure strong isolation and predictable routing on Cloudflare's edge. This approach leverages per-object storage, alarms, and RPC methods for robust stateful workloads.

What is the best way to configure SQLite storage and wrangler for Durable Objects?

SQLite storage and wrangler configuration for Durable Objects require specific setup patterns to manage per-DO lifecycle initialization and migrations correctly. Consolidating these best practices reduces misconfigurations and ensures stateful edge services operate predictably.

Can I use Vitest to test Durable Objects RPC methods?

Vitest supports testing Durable Objects RPC methods by providing structured approaches to validate initialization, concurrency, and error handling. Testing with Vitest ensures robust edge services by verifying per-entity workloads and RPC method exposure before deployment.

When do I need Durable Objects for per-entity workloads?

Durable Objects are needed for per-entity workloads like multiplayer sessions, chat rooms, or booking systems that require strong isolation, per-object storage, and alarms. They provide consistent patterns for stateful coordination where predictable routing is essential.

Does this guidance cover Durable Objects concurrency and error handling patterns?

Durable Objects concurrency and error handling patterns are covered comprehensively, addressing initialization, RPC method exposure, and observability. These best practices guard against gaps in architectural design and ensure robust stateful coordination on Cloudflare's edge.

What are the limitations of using Durable Objects for edge stateful coordination?

Limitations of Durable Objects include potential misconfigurations in wrangler setup, SQLite migrations, and lifecycle initialization if best practices are not followed. Careful architectural design is required to avoid guardrails gaps and ensure consistent stateful coordination.