Dev & Engineering

Cloudflare Agents SDK Builder

Guides developers in building stateful, real-time, and durable AI agents on Cloudflare Workers.

49/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 3.1k
Last updated
12d ago
License
Apache-2.0
cloudflare-workersagents-sdkdurable-objectswebsockets
+3mcpreact-hooksworkflow-orchestration

What does this skill do, and when should you use it?

This skill supports developers building AI agents with the Cloudflare Agents SDK. It covers the Agent class, persistent state, WebSockets, callable RPC, scheduling, Workflows, queues, retries, MCP, chat applications, and React client hooks. It prioritizes retrieval from Cloudflare’s Agents documentation because SDK knowledge may become outdated. Voice, browser tools, and Think are identified as experimental features.

It guides users through checking and installing the agents npm package, configuring Wrangler Durable Object bindings, SQLite migrations, and Workers AI bindings, and implementing Agent classes, state validation, callable methods, and routing. It also provides API examples for scheduling, workflows, durable execution, queues, retries, streaming chat, MCP, email, webhooks, push notifications, observability, and React clients, with links to Cloudflare documentation and local reference files.

Good fit
  • A developer is building a stateful chat agent or collaborative application on Cloudflare Workers.
  • A team needs WebSocket communication, callable RPC, and React hooks for a real-time client experience.
  • An engineer needs durable multi-step background processing, queued work, or retryable workflows.
  • A developer needs an agent to connect to MCP services or expose an MCP server on Cloudflare.
  • A team needs scheduled tasks, email handling, webhooks, push notifications, or diagnostic events for an agent.

How do you install this skill?

Before you use it
  • The skill covers email, browser automation, MCP, webhooks, push notifications, and code execution; review permissions, authentication, data egress, approval flows, and rollback plans before deployment.
  • Core guidance relies on retrieving Cloudflare documentation; confirm reachability in the target environment and prepare mirrors, caches, or local copies for mainland-China network constraints.
  • Examples were not executed in this review, so API compatibility, migration correctness, and production stability remain unverified.
  • No explicit version policy, changelog, or maintenance owner is provided; recheck all external references before upgrading the SDK.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Node.js and npm
  • Cloudflare Workers

This skill is part of the cloudflare/skills collection. Install the collection with npx skills add https://github.com/cloudflare/skills, or copy the relevant skill folder into the directory used by your agent client, such as ~/.codex/skills/ for OpenAI Codex. The repository does not document a separate installation command for only agents-sdk.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/cloudflare/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/agents-sdk" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Build a stateful AI agent with WebSockets on Cloudflare Workers.

In an Agent Skills-compatible client, make a request such as “Build a stateful AI agent with WebSockets on Cloudflare Workers.” Before implementation, follow the skill’s recommendation to consult https://developers.cloudflare.com/agents/. In the project, run npm ls agents; if the package is missing, run npm install agents.

What are this skill's strengths and limitations?

Pros
  • Covers a broad implementation path from Agent classes and state to workflows, queues, retries, streaming chat, and MCP.
  • Includes directly usable examples for Wrangler configuration, routing, RPC, and React hooks.
  • Explicitly prioritizes current official documentation for a fast-changing SDK.
Limitations
  • It is primarily suited to the Cloudflare Workers and Agents SDK ecosystem rather than general agent development.
  • Voice, browser tools, and Think are still marked experimental.
  • The source provides no independent test suite, performance benchmarks, or cost analysis.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Cloudflare Agents SDK Builder this page 49 · Use with care ★ 3.1k 12d ago Apache-2.0
Cloudflare Durable Objects Builder 48 · Use with care ★ 3.1k 12d ago Apache-2.0
PinMe UniwebPay Payment Integration 60 · Recommended ★ 3.7k 3mo ago MIT
Cloudflare Email Service Skill 52 · Use with care ★ 3.1k 12d ago Apache-2.0
Azure AI Foundry Agent Framework ✓ Microsoft · Official 50 · Use with care ★ 2.7k 3mo ago MIT

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
49/ 100 5-point scale 2.5 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust11 / 25 · 2.2/5

The material includes OAuth, HMAC secure replies, secret handling, MCP hardening, and human-approval examples, showing partial security awareness. However, for email, browser, webhook, push, MCP, and code-execution capabilities it does not systematically define least privilege, full data flows, sensitive-data handling, rollback, or confirmation boundaries, so points are deducted.

2Reliability8 / 20 · 2.0/5

The documents are broadly self-consistent and cover installation, configuration, core APIs, recovery, retries, and some failure messages. However, several references defer to external documentation, with no local test suite, version pinning, key-path reproduction evidence, or unified error-handling guidance. Static calibration caps this at 10, so points are deducted.

3Adaptability10 / 15 · 3.3/5

The description clearly targets stateful agents, workflows, real-time apps, MCP, chat, voice, and browser automation on Cloudflare Workers, with recognizable use cases. Non-fit boundaries, input/output contracts, and semantic trigger conditions remain incomplete, and core retrieval depends on Cloudflare-hosted documentation without evidence of mainland-China reachability or Chinese-language support, so points are deducted.

4Convention8 / 15 · 2.7/5

The skill has progressive sections, installation commands, configuration examples, reference files, experimental labels, an Apache-2.0 license, and migration cautions. It lacks explicit SDK/documentation versions, a changelog, named maintenance responsibility, an update path, troubleshooting coverage, and a systematic limitations section, so points are deducted.

5Effectiveness7 / 15 · 2.3/5

It provides directly adaptable TypeScript, React, Wrangler, and API examples across many Agents SDK features, giving it clear core utility. But the examples were not executed, some content depends on external documentation, and complex integrations still require user-side assembly, authentication, and testing. Static calibration permits at most 7, so the score is capped.

6Verifiability5 / 10 · 2.5/5

The topic table links claims to Cloudflare primary documentation and the skill includes auditable code snippets, providing limited traceability. It lacks a committed test suite, CI coverage of key paths, or third-party execution evidence; this review is static only, so the score is capped at 5.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 70215303d44a Review evidence[1][2][3][4][5][6][7][8][9][10][11][12]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does the skill deploy Cloudflare applications automatically?
It provides Wrangler configuration and deployment-related guidance, but the source does not say that it automatically performs deployments.
Which npm packages are needed for chat agents?
The source gives `npm install agents @cloudflare/ai-chat ai @ai-sdk/react`.
Is MCP a required dependency?
No. MCP is an included integration area and is relevant only when connecting to MCP services or building an MCP server.
How does it address SDK changes?
The skill explicitly recommends retrieving current information from the official Cloudflare Agents documentation instead of relying solely on pre-trained knowledge.

More skills from this repository

All from cloudflare/skills

Dev & Engineering

Cloudflare Durable Objects Builder

Build and review stateful coordination applications on Cloudflare.

★ 3.1k FS 48 Use with care 12d ago
Dev & Engineering

Cloudflare Email Service Skill

Guides agents through implementing transactional email sending, receiving, and routing on Cloudflare.

★ 3.1k FS 52 Use with care 12d ago
Dev & Engineering

Workers Production Review

Write and review production-ready Workers code using current Cloudflare guidance.

★ 3.1k FS 57 Use with care 12d ago
Dev & Engineering

Cloudflare Wrangler Deployment Guide

Helps agents reliably build, develop, deploy, and manage Cloudflare Workers with Wrangler.

★ 3.1k FS 49 Use with care 12d ago
Dev & Engineering

Cloudflare Sandbox Builder

Guides agents in building secure, isolated code execution on Cloudflare Workers.

★ 3.1k FS 46 Use with care 12d ago
Dev & Engineering

Cloudflare Platform Builder

Helps agents research and build applications on Cloudflare.

★ 3.1k FS 45 Not recommended 12d ago
Automation & Ops

Cloudflare One Migration Planner

Turns Zscaler, Palo Alto, legacy VPN, SWG, or SASE migrations into verifiable Cloudflare One plans.

★ 3.1k FS 58 Recommended 12d ago
Automation & Ops

Cloudflare One Zero Trust Advisor

Guides agents through designing, configuring, and troubleshooting Cloudflare One.

★ 3.1k FS 55 Use with care 12d ago
Dev & Engineering

Turnstile End-to-End Setup

Adds Cloudflare Turnstile to existing forms with frontend embedding, backend verification, and validation.

★ 3.1k FS 54 Use with care 12d ago
Dev & Engineering

Web Performance Auditor

Use Chrome DevTools MCP to diagnose page-load performance, Core Web Vitals, and accessibility gaps.

★ 3.1k FS 43 Not recommended 12d ago

Related skills