Merge pull request #3295 from ably/agent-skills-docs

umair-ably · web-flow · commit 84e98082467a · 2026-03-27T15:22:34.000Z
Add Agent Skills documentation and signposts across getting started guides
diff --git a/src/pages/docs/ai-transport/getting-started/anthropic.mdx b/src/pages/docs/ai-transport/getting-started/anthropic.mdx
@@ -11,6 +11,10 @@ This guide will get you started with Ably AI Transport using Anthropic's Message
 
 You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses Anthropic's Claude model with a `send_email` tool that requires user approval before execution.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/ai-transport/getting-started/langgraph.mdx b/src/pages/docs/ai-transport/getting-started/langgraph.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably AI Transport using LangGraph.
 
 You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses LangGraph with a `send_email` tool that requires user approval before execution.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/ai-transport/getting-started/openai.mdx b/src/pages/docs/ai-transport/getting-started/openai.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably AI Transport using OpenAI's Responses
 
 You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses OpenAI's GPT model with a `send_email` tool that requires user approval before execution.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/ai-transport/getting-started/vercel-ai-sdk.mdx b/src/pages/docs/ai-transport/getting-started/vercel-ai-sdk.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably AI Transport using the Vercel AI SDK.
 
 You'll learn how to authenticate users with verified identities, stream tokens from an agent to clients in realtime, and implement human-in-the-loop approval for tool calls. The agent uses the Vercel AI SDK with a `send_email` tool that requires user approval before execution.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/chat/getting-started/android.mdx b/src/pages/docs/chat/getting-started/android.mdx
@@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea
 
 ![Screenshot of the completed Android Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-kotlin-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 ### Ably <a id="prerequisites-ably"/>
diff --git a/src/pages/docs/chat/getting-started/index.mdx b/src/pages/docs/chat/getting-started/index.mdx
@@ -12,6 +12,10 @@ You'll learn the essentials of building realtime chat applications, including ho
 
 These are your first steps towards building a Chat application that can effortlessly scale to serve millions of users.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 <Tiles>
 {[
   {
diff --git a/src/pages/docs/chat/getting-started/javascript.mdx b/src/pages/docs/chat/getting-started/javascript.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably Chat using TypeScript.
 
 You'll learn how to create chat rooms, send and edit messages, and implement realtime features like typing indicators and presence. You'll also cover message history, reactions, and proper connection management.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. Sign up for an Ably account.
diff --git a/src/pages/docs/chat/getting-started/jvm.mdx b/src/pages/docs/chat/getting-started/jvm.mdx
@@ -8,6 +8,10 @@ This guide will help you get started with Ably Chat in a new JVM application usi
 
 You'll learn how to create chat rooms, send and edit messages, and implement realtime features like typing indicators and presence. You'll also cover message history, reactions, and proper connection management.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 ### Ably <a id="prerequisites-ably"/>
diff --git a/src/pages/docs/chat/getting-started/react-native.mdx b/src/pages/docs/chat/getting-started/react-native.mdx
@@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea
 
 ![Screenshot of the completed React Native Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-react-native-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 ### Ably <a id="prerequisites-ably"/>
diff --git a/src/pages/docs/chat/getting-started/react-ui-kit.mdx b/src/pages/docs/chat/getting-started/react-ui-kit.mdx
@@ -10,6 +10,10 @@ This guide shows you how to add the Ably Chat React UI Kit to a brand-new React
 
 You'll create Ably clients, install the UI component package, and build a complete chat interface. You'll also cover customizing the look and feel with your own styles, settings, and avatars.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. Sign up for an Ably account.
diff --git a/src/pages/docs/chat/getting-started/react.mdx b/src/pages/docs/chat/getting-started/react.mdx
@@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea
 
 ![Screenshot of the completed React Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-react-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 ### Ably <a id="prerequisites-ably"/>
diff --git a/src/pages/docs/chat/getting-started/swift-async-sequence.mdx b/src/pages/docs/chat/getting-started/swift-async-sequence.mdx
@@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea
 
 ![Screenshot of the completed Swift Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-swift-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 ### Ably <a id="prerequisites-ably"/>
diff --git a/src/pages/docs/chat/getting-started/swift.mdx b/src/pages/docs/chat/getting-started/swift.mdx
@@ -10,6 +10,10 @@ You'll learn how to create chat rooms, send and edit messages, and implement rea
 
 ![Screenshot of the completed Swift Chat application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../../images/content/screenshots/getting-started/chat-swift-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 ### Ably <a id="prerequisites-ably"/>
diff --git a/src/pages/docs/getting-started/dotnet.mdx b/src/pages/docs/getting-started/dotnet.mdx
@@ -10,6 +10,10 @@ This guide will get you started with Ably Pub/Sub in C# .NET.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/sign-up) for an Ably account.
diff --git a/src/pages/docs/getting-started/flutter.mdx b/src/pages/docs/getting-started/flutter.mdx
@@ -12,6 +12,10 @@ You'll establish a realtime connection to Ably and learn to publish and subscrib
 
 ![Screenshot of the completed Flutter Pub/Sub application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../images/content/screenshots/getting-started/pub-sub-flutter-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/sign-up) for a free Ably account.
diff --git a/src/pages/docs/getting-started/go.mdx b/src/pages/docs/getting-started/go.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in Go.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/getting-started/index.mdx b/src/pages/docs/getting-started/index.mdx
@@ -15,6 +15,10 @@ You'll learn the basics, such as how to connect to Ably, publish and subscribe t
 
 These are your first steps towards building a realtime application that can effortlessly scale to serve millions of users.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 <Tiles>
 {[
   {
diff --git a/src/pages/docs/getting-started/java.mdx b/src/pages/docs/getting-started/java.mdx
@@ -10,6 +10,10 @@ This guide will get you started with Ably Pub/Sub in Java.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/sign-up) for an Ably account.
diff --git a/src/pages/docs/getting-started/javascript.mdx b/src/pages/docs/getting-started/javascript.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in JavaScript.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/getting-started/kotlin.mdx b/src/pages/docs/getting-started/kotlin.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in Kotlin.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/getting-started/laravel.mdx b/src/pages/docs/getting-started/laravel.mdx
@@ -10,6 +10,10 @@ You'll learn how to create a client and establish a connection to Ably using the
 
 ![Screenshot of the completed Laravel Pub/Sub application showing a web interface with a message input field and realtime message display. The interface demonstrates the key features you'll build including publishing messages and subscribing to receive messages in realtime.](../../../images/content/screenshots/getting-started/pub-sub-laravel-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/getting-started/node.mdx b/src/pages/docs/getting-started/node.mdx
@@ -8,6 +8,10 @@ This guide will get you started with Ably Pub/Sub in Node.js.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/getting-started/objective-c.mdx b/src/pages/docs/getting-started/objective-c.mdx
@@ -14,6 +14,10 @@ This guide will get you started with Ably Pub/Sub in Objective-C.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/sign-up) for an Ably account.
diff --git a/src/pages/docs/getting-started/php.mdx b/src/pages/docs/getting-started/php.mdx
@@ -14,6 +14,10 @@ You'll learn how to connect to Ably using the REST SDK, generate JWTs for client
 This guide covers the Ably PHP SDK which provides RESTful functionality for publishing messages, retrieving history, and checking presence. If you need realtime features like subscribing to channels and receiving live updates, check out the [Ably Laravel broadcaster](https://github.com/ably/laravel-broadcaster) which integrates with Laravel's broadcasting system.
 </Aside>
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/getting-started/python.mdx b/src/pages/docs/getting-started/python.mdx
@@ -10,6 +10,10 @@ This guide will get you started with Ably Pub/Sub in Python.
 
 You'll establish a realtime connection to Ably and learn to publish and subscribe to messages. You'll also implement presence to track other online clients, and learn how to retrieve message history.
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/signup) for an Ably account.
diff --git a/src/pages/docs/getting-started/react-native.mdx b/src/pages/docs/getting-started/react-native.mdx
@@ -12,6 +12,10 @@ You'll establish a realtime connection to Ably and learn to publish and subscrib
 
 ![Screenshot of the completed React Native Pub/Sub application showing a web interface with connection status, a message input field, realtime message display, and a presence indicator showing online users. The interface demonstrates the key features you'll build including publishing messages, subscribing to receive messages in realtime, and tracking which clients are currently present in the channel.](../../../images/content/screenshots/getting-started/pub-sub-react-native-getting-started-guide.png)
 
+<Aside data-type='note'>
+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
+</Aside>
+
 ## Prerequisites <a id="prerequisites"/>
 
 1. [Sign up](https://ably.com/sign-up) for a free Ably account.
diff --git a/src/pages/docs/getting-started/react.mdx b/src/pages/docs/getting-started/react.mdx
diff --git a/src/pages/docs/getting-started/ruby.mdx b/src/pages/docs/getting-started/ruby.mdx
diff --git a/src/pages/docs/getting-started/swift.mdx b/src/pages/docs/getting-started/swift.mdx
diff --git a/src/pages/docs/platform/ai-llms/index.mdx b/src/pages/docs/platform/ai-llms/index.mdx
diff --git a/src/pages/docs/push/getting-started/apns.mdx b/src/pages/docs/push/getting-started/apns.mdx
diff --git a/src/pages/docs/push/getting-started/fcm.mdx b/src/pages/docs/push/getting-started/fcm.mdx
diff --git a/src/pages/docs/push/getting-started/web.mdx b/src/pages/docs/push/getting-started/web.mdx

Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,10 @@ You'll learn the essentials of building realtime chat applications, including ho`
`12`	`12`
`13`	`13`	`These are your first steps towards building a Chat application that can effortlessly scale to serve millions of users.`
`14`	`14`
	`15`	`+<Aside data-type='note'>`
	`16`	+Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for all popular AI coding agents. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
	`17`	`+</Aside>`
	`18`	`+`
`15`	`19`	`<Tiles>`
`16`	`20`	`{[`
`17`	`21`	`{`