skilld
All skills
cloudflare avatar

/agents-sdk

@41e0d19 official
by cloudflarecloudflare/skills3k stars
298

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/cloudflare/skills/agents-sdk

This session only. Nothing lands on disk.

referencesclient-sdk.md

≈304 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Client SDK

Choose useAgent for React state/RPC, AgentClient for other WebSocket clients, and agentFetch for one-off HTTP requests. Add useAgentChat when the UI needs chat messages and streaming. Check installed package versions before adapting current examples.

Task Documentation
Connect, sync state, call RPC, or send HTTP requests Client SDK — hooks, vanilla JS, typed calls, streaming callbacks, and connection options
Build chat UI Chat agents — useAgentChat, message rendering, status, and tool interactions
Authenticate across origins Cross-domain authentication — token validation and WebSocket authentication

Keep client instance selection consistent with server routing. For authentication, account for token refresh on reconnect and query caching. Close manually created AgentClient connections when finished; React hooks manage their own cleanup.

Source: SKILL.md on GitHub

Third-party checks

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides reference documentation and configuration guidelines for building, debugging, and reviewing applications using the Cloudflare Agents SDK. It consists entirely of educational markdown files and contains no executable code or security risks.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    8 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 41e0d19. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 5 hours ago.

Activeupdated 7 hours ago

Topics

  • MCP
  • cloudflare
  • workers
  • agents
  • state-management
  • websocket
  • durable-objects
  • scheduling
  • workflows
  • observable

README badge

README badge for cloudflare/skills/agents-sdk

What it does

Builds stateful AI agents on Cloudflare Workers using Durable Objects, with APIs for persistent state, callable RPC methods, scheduling, workflows, durable execution, queues, and streaming chat. Covers the full lifecycle of agent development from configuration through observability, with experimental support for voice, browser automation, and MCP integration.

Generated from the current SKILL.md.

Frequently asked

Does this work with existing Cloudflare Workers projects?
Yes. Use the 'Add to existing project' guide to install the SDK into an existing Workers app. You'll need to configure durable objects and migrations in wrangler.jsonc.
What state management does the SDK provide?
SQLite-backed persistent state that auto-syncs to clients via setState(). State changes trigger validateStateChange() and onStateUpdate() hooks, and the SDK includes built-in SQL query support.
Can I use this with chat applications?
Yes. The SDK includes AIChatAgent for streaming chat with tools, message persistence, and resumable streams. It requires @cloudflare/ai-chat and ai packages.
Does this support background workflows and scheduled tasks?
Yes. The SDK provides AgentWorkflow for durable multi-step tasks, schedule() / scheduleEvery() for one-time and recurring tasks, and runFiber() for work that survives durable object eviction.
Can I connect to external MCP servers or build MCP servers with this?
Yes. The SDK includes MCP client integration to connect to external MCP servers and McpAgent to build MCP servers with configurable transports (HTTP, SSE, RPC).

Generated from the current SKILL.md. These answers refresh after source changes.