Why do I get 'I/O context' errors in my workflow?

This error occurs when you perform I/O operations like fetch or KV access outside of a step.do() block. This skill provides tools to identify and move these operations into the correct durable context.

Does this skill help with local testing?

Absolutely. It includes specific commands and scripts to validate your wrangler.jsonc configuration and test workflow instances locally before deployment.

What are Cloudflare Workflows?

Cloudflare Workflows allow you to build durable, multi-step applications that can run for long periods, maintain state, and automatically retry upon failure.

Can I pause a workflow to wait for an external event?

Yes, using the step.waitForEvent() method, you can pause execution until an external trigger—such as a webhook or manual approval—is received.

How do I stop a workflow from retrying forever?

By throwing a NonRetryableError within a step, you can signal that a failure is permanent (like a 404 error) and that the workflow should stop attempting retries.

Cloudflare Workflows

Name: Cloudflare Workflows
Author: secondsky

bysecondsky

•

Cloud Infrastructure

Implements durable, long-running execution patterns using Cloudflare Workflows with automatic state persistence and specialized error handling.

About

This skill provides a production-ready framework for building robust, stateful processes on the Cloudflare platform. It enables Claude to scaffold WorkflowEntrypoint classes, manage complex execution steps, and handle failures using specialized patterns like NonRetryableError. Whether you are building human-in-the-loop approvals, multi-day scheduled tasks, or event-driven microservices, this skill ensures your workflows are correctly configured to avoid common pitfalls like I/O context errors and serialization failures.

Key Features

21 GitHub stars
Automated scaffolding for WorkflowEntrypoint classes and Wrangler configurations
Smart debugging for common I/O context and state serialization errors
Advanced implementation of step.do, step.sleep, and step.waitForEvent methods
Standardized retry logic patterns and permanent failure handling
Pre-built templates for sequential, scheduled, and event-driven workflows

Use Cases

Implementing human-in-the-loop workflows such as payment approvals or manual data reviews
Building reliable user onboarding sequences with time-delayed notifications
Orchestrating multi-step API integrations that require state persistence between calls

About

Key Features

21 GitHub stars
Automated scaffolding for WorkflowEntrypoint classes and Wrangler configurations
Smart debugging for common I/O context and state serialization errors
Advanced implementation of step.do, step.sleep, and step.waitForEvent methods
Standardized retry logic patterns and permanent failure handling
Pre-built templates for sequential, scheduled, and event-driven workflows

Use Cases

Implementing human-in-the-loop workflows such as payment approvals or manual data reviews
Building reliable user onboarding sequences with time-delayed notifications
Orchestrating multi-step API integrations that require state persistence between calls