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.

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

0121 GitHub stars

02Automated scaffolding for WorkflowEntrypoint classes and Wrangler configurations

03Smart debugging for common I/O context and state serialization errors

04Advanced implementation of step.do, step.sleep, and step.waitForEvent methods

05Standardized retry logic patterns and permanent failure handling

06Pre-built templates for sequential, scheduled, and event-driven workflows

Use Cases

01Implementing human-in-the-loop workflows such as payment approvals or manual data reviews

02Building reliable user onboarding sequences with time-delayed notifications

03Orchestrating multi-step API integrations that require state persistence between calls

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add secondsky/claude-skills cloudflare-workflows

For use in Claude.ai and ChatGPT

Download Skill