AGENT DEVELOPMENT / Cloudflare
Cloudflare Agents SDK
Guides stateful Cloudflare agent applications through current SDK documentation, persistence, scheduling and approval-aware tool flows.
“Build, debug, or review Cloudflare Agents SDK applications using the agents package.”
01 / THE REASONING
Why this made the selection.
- Treats installed SDK versions and current docs as the basis for implementation.
- Explains the difference between synchronized state, database history, chat-tool approvals and durable-workflow pauses.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/agents-sdk/SKILL.md
- skills/agents-sdk/references/human-in-the-loop.md
- skills/agents-sdk/references/state-scheduling.md
- LICENSE
- skills/agents-sdk/SKILL.md and both inspected references compared with the previous review revision b052c32b: every changed line is a documentation link, now to an index.md Markdown page; the instructions are otherwise unchanged.
Our findings
- The definition checks SDK installation, bindings and migrations and warns against editing old migration tags.
- The state reference separates validation of proposed updates from reactions to accepted changes.
- The human-in-the-loop reference distinguishes approval responses from client tool outputs and calls for timeout handling before gated work.
- The definition opens with "Prefer retrieval over pre-training" and links each topic, from state and scheduling to MCP and experimental voice, to a Markdown (index.md) Cloudflare docs page.
Not established by this review
- Source inspection only; no skill installation or workflow execution was performed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add cloudflare/skills/skills/agents-sdk Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/cloudflare/skills/tree/53395984c3ea1925d00fce03b266112302f050e6/skills/agents-sdk - Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
- Choose your AI tools and project or global scope in the installer, then review its permissions before using the skill.
Before you start
- Node.js/npm for this installer
- An agent that supports the Agent Skills format
- A configured Workers project
- Cloudflare account access for deployment and provider credentials where used
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/agents-sdk/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/agents-sdk/references/human-in-the-loop.md
Supports: review, limitations, access
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/agents-sdk/references/state-scheduling.md
Supports: review, limitations, access
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE
Supports: license
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md
Supports: install, compatibility, access
https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/git.ts
Supports: install
https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/agents-sdk/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt