A sample Slack agent built with Bolt for JavaScript that answers as your agent and keeps your runbooks current. Runbooks are Slack canvases titled Runbook: <topic>. The agent answers from them, and it learns from the messages in your channels, so the runbooks it writes are the ones it answers from next time.
This repo contains the same app built with two different AI agent frameworks. Pick the one that fits your stack:
| App | Directory | Get Started | Framework |
|---|---|---|---|
| Claude Agent SDK | claude-agent-sdk/ |
View README | claude-agent-sdk |
| OpenAI Agents SDK | openai-agents-sdk/ |
View README | openai-agents |
All implementations share the same Slack listener layer and the same user experience. The only difference is how the agent is defined and executed under the hood.
Install the Slack MCP and 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.
Run this in a Claude Code session:
/plugin marketplace add slackapi/slack-skills-plugin
/plugin install slack@slack
Enable auto-updates: /plugin > Marketplaces > slack > Enable auto-update.
Run this in your terminal:
codex plugin marketplace add slackapi/slack-skills-plugin
codex plugin add slack@slackRun this in a Cursor Agent chat:
/add-plugin slack
Install the skills with npx skills, using your agent's identifier:
npx skills add slackapi/slack-skills-plugin -y -a <agent>
# For example, OpenCode
npx skills add slackapi/slack-skills-plugin -y -a opencodeThe personal agent interacts with you through five entry points:
- App Home — Displays a welcome message with instructions on how to interact.
- Direct Messages — Message the agent directly to find a runbook or triage a request. It responds in-thread, maintaining context across follow-ups.
- Channel @mentions — Mention the agent in a channel with a request. It answers from a runbook when one covers it, or offers to start one.
- Channel messages — The agent follows along in channels it's a member of. When a message settles something worth keeping, the agent adds it to your runbooks on its own.
- Assistant Panel — Click Add Agent in Slack, select the agent, and pick from suggested prompts or type a message.
The agent's voice and answers are shaped by a SOUL.md file that the owner (set via OWNER_USER_ID) creates through an interview or edits directly. The owner also has access to the /brief command, which searches recent mentions and requests and lists what needs attention.
With the bot token, the agent lists, reads, and creates runbooks. When you connect the Slack MCP Server from the Home tab, the agent works with runbooks as you in your DMs with it, which can also update existing runbooks. When the agent changes a runbook, it tells the message's author with an ephemeral message only they can see.
For full setup instructions, pick a framework above and follow the README in that directory.