From 3a4477ede242ba34e4f41a58c5460270ab5cad56 Mon Sep 17 00:00:00 2001
From: Michael Brooks <mbrooks@slack-corp.com>
Date: Tue, 20 Oct 2026 14:15:14 -0600
Subject: [PATCH] docs: add slack plugin install steps for coding agents

---
 README.md                   | 40 +++++++++++++++++++++++++++++++++++++
 claude-agent-sdk/README.md  | 40 +++++++++++++++++++++++++++++++++++++
 openai-agents-sdk/README.md | 40 +++++++++++++++++++++++++++++++++++++
 3 files changed, 120 insertions(+)

diff --git a/README.md b/README.md
index c80a34c..6e9aeb0 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,46 @@ A sample Slack agent that showcases [Slack Code](https://docs.slack.dev/ai/slack
 | **Claude Agent SDK**  | `claude-agent-sdk/`  | [View README](./claude-agent-sdk/README.md)  | [claude-agent-sdk](https://platform.claude.com/docs/en/agent-sdk/overview) |
 | **OpenAI Agents SDK** | `openai-agents-sdk/` | [View README](./openai-agents-sdk/README.md) | [openai-agents](https://openai.github.io/openai-agents-js/)                |
 
+## Claude Code, Codex, Cursor, and Other Coding Agents
+
+Install the [Slack MCP and Skills Plugin](https://docs.slack.dev/ai/slack-skills-plugin/) so your coding agent can create, run, and deploy Slack apps, look up Web API methods and scopes, and build Block Kit without guessing.
+
+### Claude Code
+
+Run this in a Claude Code session:
+
+```
+/plugin install slack@claude-plugins-official
+```
+
+### Codex
+
+Run this in your terminal:
+
+```sh
+codex plugin marketplace add slackapi/slack-skills-plugin
+codex plugin add slack@slack
+```
+
+### Cursor
+
+Run this in a Cursor Agent chat:
+
+```
+/add-plugin slack
+```
+
+### Other agents
+
+Install the skills with `npx skills`, using your [agent's identifier](https://github.com/vercel-labs/skills#supported-agents):
+
+```sh
+npx skills add slackapi/slack-skills-plugin -y -a <agent>
+
+# For example, OpenCode
+npx skills add slackapi/slack-skills-plugin -y -a opencode
+```
+
 ## What it can do
 
 - **Channel @mentions and direct messages** — Mention the agent with a task, or message it directly. Quick questions get an answer in place; work that takes more than one message gets a code channel linked back to your message, along with the conversation it came from.
diff --git a/claude-agent-sdk/README.md b/claude-agent-sdk/README.md
index c836a27..06c9391 100644
--- a/claude-agent-sdk/README.md
+++ b/claude-agent-sdk/README.md
@@ -70,6 +70,46 @@ Before getting started, make sure you have a development workspace where you hav
 
 Join the [Slack Developer Program](https://api.slack.com/developer-program) for exclusive access to sandbox environments for building and testing your apps, tooling, and resources created to help you build and grow.
 
+### Claude Code, Codex, Cursor, and Other Coding Agents
+
+Install the [Slack MCP and Skills Plugin](https://docs.slack.dev/ai/slack-skills-plugin/) so your coding agent can create, run, and deploy Slack apps, look up Web API methods and scopes, and build Block Kit without guessing.
+
+#### Claude Code
+
+Run this in a Claude Code session:
+
+```
+/plugin install slack@claude-plugins-official
+```
+
+#### Codex
+
+Run this in your terminal:
+
+```sh
+codex plugin marketplace add slackapi/slack-skills-plugin
+codex plugin add slack@slack
+```
+
+#### Cursor
+
+Run this in a Cursor Agent chat:
+
+```
+/add-plugin slack
+```
+
+#### Other agents
+
+Install the skills with `npx skills`, using your [agent's identifier](https://github.com/vercel-labs/skills#supported-agents):
+
+```sh
+npx skills add slackapi/slack-skills-plugin -y -a <agent>
+
+# For example, OpenCode
+npx skills add slackapi/slack-skills-plugin -y -a opencode
+```
+
 ### Create the Slack app
 
 <details><summary><strong>Using Slack CLI</strong></summary>
diff --git a/openai-agents-sdk/README.md b/openai-agents-sdk/README.md
index cda25df..ca8ff93 100644
--- a/openai-agents-sdk/README.md
+++ b/openai-agents-sdk/README.md
@@ -68,6 +68,46 @@ Before getting started, make sure you have a development workspace where you hav
 
 Join the [Slack Developer Program](https://api.slack.com/developer-program) for exclusive access to sandbox environments for building and testing your apps, tooling, and resources created to help you build and grow.
 
+### Claude Code, Codex, Cursor, and Other Coding Agents
+
+Install the [Slack MCP and Skills Plugin](https://docs.slack.dev/ai/slack-skills-plugin/) so your coding agent can create, run, and deploy Slack apps, look up Web API methods and scopes, and build Block Kit without guessing.
+
+#### Claude Code
+
+Run this in a Claude Code session:
+
+```
+/plugin install slack@claude-plugins-official
+```
+
+#### Codex
+
+Run this in your terminal:
+
+```sh
+codex plugin marketplace add slackapi/slack-skills-plugin
+codex plugin add slack@slack
+```
+
+#### Cursor
+
+Run this in a Cursor Agent chat:
+
+```
+/add-plugin slack
+```
+
+#### Other agents
+
+Install the skills with `npx skills`, using your [agent's identifier](https://github.com/vercel-labs/skills#supported-agents):
+
+```sh
+npx skills add slackapi/slack-skills-plugin -y -a <agent>
+
+# For example, OpenCode
+npx skills add slackapi/slack-skills-plugin -y -a opencode
+```
+
 ### Create the Slack app
 
 <details><summary><strong>Using Slack CLI</strong></summary>