agents-sdk Skill for Claude: Build Cloudflare Agents With the Agents SDK

agents-sdk helps your coding assistant build, debug and review apps on the Cloudflare Agents SDK instead of guessing from old training data.

Installs: 112.3K; on skills.sh
Stars: 3.2K; on GitHub
Files: 20; besides SKILL.md
Updated: Oct 2026; last repo commit

agents-sdk tells the assistant that its memory of the Agents SDK may be out of date and to look things up first. It carries a table of Cloudflare docs pages by topic, a short wrangler config, a sample agent class and a list of core calls for state, SQL, scheduling, RPC, workflows and queues. Longer guides sit in 20 reference files that it opens when a task needs them.

It loads when you build, debug or review an app that uses the agents package. It starts by telling the assistant to check that the agents package is installed and gives the npm install command if it is not. It bundles no scripts.

Good for

Developers building stateful AI agents on Cloudflare Workers
Teams adding MCP servers, email or scheduled tasks to an agent
Reviewers checking Agents SDK code against current docs

Install agents-sdk

Claude Code

Copy this prompt.

Install the agents-sdk skill in Claude Code. Run this command:

/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflare

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both. The README says the plugin installs the Cloudflare guidance and the main Cloudflare MCP server, and it brings every skill in the repo. The skills CLI route installs only this skill.

From the project README. Source.

What's in the skill

When it loads

Build, debug, or review Cloudflare Agents SDK applications using the agents package.

Sections in SKILL.md

Retrieval Sources
Capabilities
FIRST: Verify Installation
Wrangler Configuration
Agent Class
Routing
Core APIs
React Client
References
Core
Chat & Streaming
Background Processing
Integrations
Experimental
Skill feedback

Key facts

Author: cloudflare (GitHub)
Repository: cloudflare/skills, folder skills/agents-sdk
Installs on skills.sh: 112,293 (as of 2026-11-02)
Repo stars: 3,244 (whole repository, as of 2026-11-02)
License: Apache-2.0
Last repo commit: 2026-10-31
Files in the skill folder: 21 files: SKILL.md and 20 reference files
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn

What it includes

Maps each Agents SDK topic to its Cloudflare docs page
Tells the assistant to prefer retrieval over pre-training and lists docs pages for state, routing, scheduling, workflows, chat, MCP and more.
Network · Retrieval table
Check the agents package and add it if missing
Runs `npm ls agents` and, if the package is missing, gives the `npm install agents` command (plus the chat packages for chat agents).
Runs code · Verify installation
Config snippet plus gotchas
Shows the compatibility flag, Durable Object binding and migration entry an agent class needs, and warns not to edit old migrations.
Write · Wrangler configuration
Sample class and a table of calls
Covers state, SQL, schedule, scheduleEvery, callable RPC, workflows, durable fibers, queue, retry and broadcast.
Agent class and core APIs
Topic files opened on demand
Core, chat and streaming, background processing, integrations and experimental topics such as voice and browser tools.
Read · Reference guides
If you report wrong guidance, it may offer to file a public issue
A bundled skill-feedback.md has the assistant ask permission, draft an issue for cloudflare/skills, show you the exact text and post it with `gh issue create` only after you say yes.
Network · Skill feedback

From the official docs

Permissions

Low risk

It can run npm commands and edit your Worker config, and if you report bad guidance it may offer to post a public GitHub issue after you approve the text. Review the diff before you deploy.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can install an npm package
The first step runs an npm check and installs `agents` if it is missing. Check your package.json and lockfile diff.
It edits your Worker config
Its Wrangler section shows a Durable Object binding and a migration entry for each agent class and warns never to edit old migrations. Review any config edits before you deploy.
The plugin route also adds Cloudflare's MCP server
The README says the Claude Code plugin installs the Cloudflare guidance and the main remote Cloudflare MCP server, which gives access to the Cloudflare API and docs. The skills CLI route installs only this skill.
Skill feedback can post a public GitHub issue
A bundled skill-feedback.md tells the assistant what to do if you report wrong or outdated guidance: ask your permission, draft an issue for cloudflare/skills, show you the exact title and body and post only after you answer yes. It uses `gh issue create`, and the issue is public, so check the text for secrets before you approve.

Technical details

Talks to	npm registry and Cloudflare docs, when it installs or looks things up

Questions

What does the agents-sdk skill do?

It helps your assistant write correct Cloudflare Agents SDK code. It points to current Cloudflare docs, shows the config and class patterns, and opens focused guides for state, scheduling, MCP, email and chat.

How do I install agents-sdk?

Use the install box at the top of the page. The plugin route installs every Cloudflare skill plus the Cloudflare MCP server, and the skills CLI route installs only this one.

Does agents-sdk need an API key?

The SKILL.md asks for no key. Your own Cloudflare account and wrangler setup are what deploy the agent you build.

Does it work in Codex or Cursor?

The Cloudflare README gives install steps for Codex, VS Code with GitHub Copilot and Cursor as well as Claude Code.

Is agents-sdk safe?

It is instructions, not code, and it bundles no scripts. It does tell the assistant to run npm commands and edit config, so review those changes. Do not enable the experimentalDecorators option in tsconfig, which the skill warns breaks @callable.

How is it different from the durable-objects skill?

agents-sdk covers the agents package, whose agent classes use Durable Object bindings. The durable-objects skill in the same repo is for stateful coordination such as chat rooms, RPC, SQLite and alarms directly. Use agents-sdk for agent apps and durable-objects for lower-level work.

Information

updated Nov 2, 2026

Repository: cloudflare/skills
Folder: skills/agents-sdk

cloudflare/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

cloudflare/skills README · github.com
skills.sh listing · skills.sh
agents-sdk SKILL.md · github.com
agents-sdk skill-feedback.md · github.com