Skip to content

About

An AI agent that answers for you in Slack and turns channel decisions into runbooks

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

Personal Agent for Slack

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.

Choose Your Framework

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.

Claude Code, Codex, Cursor, and Other Coding Agents

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.

Claude Code

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.

Codex

Run this in your terminal:

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:

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

The 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.

About

An AI agent that answers for you in Slack and turns channel decisions into runbooks

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Contributors

Languages