agents-sdk

agents-sdk is a skill for Claude Code from fcakyon/claude-codex-settings. It costs 19 tokens per session (2,829 once invoked), scanned A, original, Apache-2.0.

A guide for building, debugging, and reviewing applications with Cloudflare's Agents SDK. The SDK provides tools for agents that can keep state, handle requests, run scheduled work, and perform multi-step workflows.

In plain words
What is it for?
Use it to create agent projects, add agents to Workers apps, manage state, expose callable methods, schedule tasks, run workflows, and build chat agents.
Why use it?
It gives the coding agent a current reference for APIs and configuration that may change over time.

Skill for Claude Code

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

Part of the cloudflare-skills plugin — 14 skills shipped together

Good fit Use it to create agent projects, add agents to Workers apps, manage state, expose callable methods, schedule tasks, run workflows, and build chat agents.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/fcakyon/claude-codex-settings/agents-sdk
About the project

claude-codex-settings is a collection of configurations and reusable extensions for Claude Code, OpenAI Codex, Cursor, and related coding tools. Developers use its skills, commands, hooks, agents, plugins, and MCP servers to shape coding-agent workflows and connect alternative model APIs. The catalogue entries are components of this collection that can be installed into supported coding tools.

fcakyon/claude-codex-settings · 1,139 stars · on GitHub · claudesettings.com

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 fcakyon/claude-codex-settings --skill agents-sdk
Clone the repo
git clone --depth 1 https://github.com/fcakyon/claude-codex-settings

Made for: Claude Code.

Or install cloudflare-skills, the plugin that ships this one along with the rest of its 14 skills.

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/fcakyon/claude-codex-settings/agents-sdk/github.svg)](https://agentmods.dev/skills/fcakyon/claude-codex-settings/agents-sdk)
Your own site
<a href="https://agentmods.dev/skills/fcakyon/claude-codex-settings/agents-sdk"><img src="https://agentmods.dev/badge/skills/fcakyon/claude-codex-settings/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/fcakyon/claude-codex-settings/agents-sdk"><img src="https://agentmods.dev/badge/skills/fcakyon/claude-codex-settings/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,829 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.
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.02829
Opus 5 $0.00010 $0.01414
Sonnet 5 $0.00004 $0.00566
Haiku 4.5 $0.00002 $0.00283

Measured yesterday against content hash db98457d9de8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, 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 yesterday.

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)`.
plugins/cloudflare-skills/skills/agents-sdk/SKILL.md · 204 lines

How it starts

The opening of the file, as written. The whole thing — 204 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/

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 · 204 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. yesterday First seen · 204 lines · 19 tokens per session scan A db98457d9de8

Subscribe to this mod's changes

agents-sdk is a skill published in the GitHub repository fcakyon/claude-codex-settings (1,139 stars, last pushed yesterday), licensed Apache-2.0. It adds 19 tokens to every session and 2,829 once invoked, about $0.0001 per session on Opus 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-09-09.

Related

Other skills, from other repositories

lov-optimize-tauri-backend

Optimize Tauri backend architecture and development ergonomics for Tauri 2 apps, especially Rust restart pain, oversized src-tauri/src/lib.rs files, excessive #[tauri::command] surfaces, stringly invoke APIs, long IPC streams, and dev-state recovery. Use when the user asks about Tauri hot reload, Rust-side restarts…

lovstudio/skills · 125 tokens

lov-cli2anything

A tool for turning authorized observations of a website’s API into an OpenAPI description, Swagger interface, JavaScript SDK, or local command-line tool. OpenAPI is a machine-readable description of how an API can be called.

lovstudio/skills · 55 tokens

lov-init-auth

A React authentication setup tool for Supabase, a hosted service that provides user accounts and data features. It adds account access, recovery, email confirmation, and desktop-browser OAuth, where OAuth lets users sign in through another provider.

lovstudio/skills · 42 tokens

lov-install-zenmux-api

A backend integration tool for connecting an application to the ZenMux API through a server-side proxy. It keeps API keys on the server instead of exposing them in browser code.

lovstudio/skills · 47 tokens

lov-refactor-api

A backend API refactoring workflow that finds duplicate endpoints and consolidates their implementation while keeping existing callers working. It checks inputs, outputs, permissions, and known callers before changing code.

lovstudio/skills · 41 tokens

platform-api

Queries the Genesys Cloud Platform API schema for endpoint details, permissions, parameters, and response formats. Use when user asks about Genesys Cloud API endpoints (e.g., "/api/v2/assistants/queues"), API documentation, API permissions, schemas, capabilities, or when implementing Genesys Cloud operations.

MakingChatbots/genesys-cloud-skills · 65 tokens