agents-sdk

agents-sdk is a skill for Claude Code from cloudflare/skills. It costs 19 tokens per session (2,896 once invoked), scanned A, original, Apache-2.0.

Instructions for building AI agents on Cloudflare Workers with the Agents SDK. Cloudflare Workers are programs that run on Cloudflare’s network, and the SDK supports stateful agents, scheduled work, workflows, WebSockets, and related applications.

In plain words
What is it for?
Use it to build chat or voice agents, browser automation, MCP servers, real-time apps, scheduled tasks, and durable multi-step workflows.
Why use it?
It gives developers current guidance for setting up and configuring these applications, including how agents store state and communicate with clients.

Skill for Claude Code ✓ vendor

Written for Claude Code: shipped in a Claude Code plugin.

Part of the cloudflare plugin — 19 skills, 1 MCP server shipped together

Good fit Use it to build chat or voice agents, browser automation, MCP servers, real-time apps, scheduled tasks, and durable multi-step workflows.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cloudflare/skills/agents-sdk
About the project

Cloudflare Skills is a collection of instructions and tools that help coding agents build on Cloudflare Workers, the Agents SDK, and other Cloudflare developer services. It is for agents and developers using Cloudflare’s platform. The catalogue entries package the project’s guidance as skills, commands, rules, plugins, and MCP tools.

cloudflare/skills · 3,108 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add cloudflare/skills --skill agents-sdk
Clone the repo
git clone --depth 1 https://github.com/cloudflare/skills

Made for: Claude Code.

Or install cloudflare, the plugin that ships this one along with the rest of its 19 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agents-sdk

README.md
[![agentmods](https://agentmods.dev/badge/skills/cloudflare/skills/agents-sdk/github.svg)](https://agentmods.dev/skills/cloudflare/skills/agents-sdk)
Your own site
<a href="https://agentmods.dev/skills/cloudflare/skills/agents-sdk"><img src="https://agentmods.dev/badge/skills/cloudflare/skills/agents-sdk/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for agents-sdk

Your own site · 80×15
<a href="https://agentmods.dev/skills/cloudflare/skills/agents-sdk"><img src="https://agentmods.dev/badge/skills/cloudflare/skills/agents-sdk.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 19 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,896 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 15 Sept 2026
  • Snyk pass 15 Sept 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00019 $0.02896
Opus 5.5 $0.00008 $0.01158
Sonnet 5.5 $0.00004 $0.00579
Haiku 4.5 $0.00002 $0.00290

Measured 18d ago against content hash 95890d0c50e3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

agents-sdk scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 18d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

Custom routing: use `getAgentByName(env.MyAgent, "instance-id")` then `agent.fetch(request)`.
Origin

Copies of this mod

4 near-identical copies found in the catalogue:

skills/agents-sdk/SKILL.md · 203 lines

How it starts

The opening of the file, as written. The whole thing — 203 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Cloudflare Agents SDK

Your knowledge of the Agents SDK may be outdated. Prefer retrieval over pre-training for any Agents SDK task.

Retrieval Sources

Cloudflare docs: https://developers.cloudflare.com/agents/index.md

Topic Docs URL Use for
Getting started Quick start First agent, project setup
Adding to existing project Add to existing project Install into existing Workers app
Configuration Configuration wrangler.jsonc, bindings, assets, deployment
Agent class Agents API Agent lifecycle, patterns, pitfalls
State Store and sync state setState, validateStateChange, persistence
Routing Routing URL patterns, routeAgentRequest
Callable methods Callable methods @callable, RPC, streaming, timeouts
Scheduling Schedule tasks schedule(), scheduleEvery(), cron
Workflows Run workflows AgentWorkflow, durable multi-step tasks
HTTP/WebSockets WebSockets Lifecycle hooks, hibernation
Chat agents Chat agents AIChatAgent, streaming, tools, persistence
Client SDK Client SDK useAgent, AgentClient, state, RPC, HTTP
Client tools Client tools Client-side tools, autoContinueAfterToolResult
Server-driven messages Autonomous responses saveMessages, waitUntilStable, server-initiated turns
Resumable streaming Chat agents Stream recovery on disconnect
Email Email Email routing, secure reply resolver
MCP client MCP client Connecting to MCP servers
MCP server MCP server Building MCP servers with createMcpHandler
MCP transports MCP transports Streamable HTTP, SSE, RPC transport options
Securing MCP servers Securing MCP OAuth, proxy MCP, hardening
Human-in-the-loop Human-in-the-loop Workflow approvals, elicitation, timeout handling
Durable execution Durable execution runFiber(), stash(), surviving DO eviction
Queue Queue Built-in FIFO queue, queue()
Retries Retries this.retry(), backoff/jitter
Observability Observability Diagnostics-channel events
Push notifications Push notifications Web Push + VAPID from agents
Webhooks Webhooks Receiving external webhooks
Cross-domain auth Cross-domain auth WebSocket auth, tokens, CORS
Readonly connections Readonly shouldConnectionBeReadonly
Voice Voice Experimental STT/TTS, withVoice
Browse the web Browser tools Experimental CDP browser automation
Think Think Experimental higher-level chat agent class
Migrations AI SDK v5, AI SDK v6 Upgrading @cloudflare/ai-chat

Read the full file on GitHub · 203 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 18d ago Changed 95890d0c50e3
  2. 1mo ago Changed · -19 lines · -68 tokens per session 59332861a1da
  3. 1mo ago First seen · 222 lines · 87 tokens per session scan A a05244d3cfb2

Subscribe to this mod's changes

agents-sdk is a skill published in the GitHub repository cloudflare/skills (3,108 stars, last pushed today), licensed Apache-2.0. It adds 19 tokens to every session and 2,896 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

cloudflare-hygiene

Audit + harden + optimize live Cloudflare zones/domains - read-only sweep of each zone (SSL/TLS mode, HSTS, min TLS, TLS 1.3, Always-Use-HTTPS, Brotli, HTTP/3, 0-RTT, Early Hints, caching, security level, Bot Fight Mode, WAF, DNS proxy/TTL + SPF/DKIM/DMARC hygiene, DNSSEC) -> ok/attention/action report grouped by…

pivoshenko/pivoshenko.ai · 220 tokens

airflow-state-store

Persists task and asset state across retries and DAG runs using Airflow 3.3's AIP-103 key/value stores (taskstatestore, assetstatestore) and the crash-safe ResumableJobMixin. Use when the user asks about task state store, checkpointing in tasks, persisting state across retries, job IDs surviving worker crashes…

astronomer/agents · 243 tokens

configuring-airflow-language-sdks

Configures Airflow to run language SDK tasks (Java, Go, and future native SDKs) — register a coordinator, map a queue to it, ensure the runtime/artifact on workers, and tune coordinator options. Use when the user wants Airflow to route a queue to a native-language coordinator, asks about the [sdk]…

astronomer/agents · 155 tokens

deploying-airflow

Deploys Airflow DAGs and projects. Use when deploying Airflow or answering anything about deployment - deploying DAGs/projects, pushing code, setting up CI/CD, deploying to production or deployment strategies for Airflow.

astronomer/agents · 48 tokens

troubleshooting-astro-deployments

Troubleshoot Astronomer production deployments with Astro CLI. Use when investigating deployment issues, viewing production logs, analyzing failures, or managing deployment environment variables.

astronomer/agents · 40 tokens

managing-astro-deployments

Manage Astronomer production deployments with Astro CLI. Use when the user wants to authenticate, switch workspaces, create/update/delete deployments, or deploy code to production.

astronomer/agents · 41 tokens