How do I install the Slack skill?

Run npx skillmds@latest add builderio/slack in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Slack safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Slack?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Slack free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Builder.io (@builderio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Slack by builderio — Agent Skill

Name: Slack
Author: Builder.io

File contents

Slack Integration

Connection

Base URL: https://slack.com/api/
Auth: Authorization: Bearer $SLACK_BOT_TOKEN (or $SLACK_BOT_TOKEN_2 for secondary workspace)
Credentials: SLACK_BOT_TOKEN (primary), SLACK_BOT_TOKEN_2 (secondary workspace)
Caching: 2-minute in-memory cache, max 200 entries; separate user/bot caches

Server Lib

File: server/lib/slack.ts

Exported Functions

Function	Description
`getTeamInfo(workspace)`	Get workspace info
`listChannels(workspace)`	List channels (paginated, first page cached)
`getChannelHistory(workspace, channelId, limit?, cursor?)`	Channel message history
`searchMessages(workspace, query, count?)`	Search messages
`getUserInfo(workspace, userId)`	Get user info (cached per user)
`getBotInfo(workspace, botId)`	Get bot info (cached)
`resolveUsers(workspace, userIds, messages?)`	Batch resolve user names

Agent Action

Use slack-messages for agent-facing Slack reads. Do not call /api/slack/* directly from the agent.

Mode	Args	Description
`team`	`workspace`	Get workspace info
`channels`	`workspace`	List channels
`history`	`workspace`, `channel`, `limit`, `cursor`	Read channel history
`multi-history`	`workspace`, `channels`, `names`, `limit`, `cursors`	Read multiple channels
`search`	`workspace`, `query`	Search messages

Key Patterns & Gotchas

Two workspaces supported via workspace parameter ("primary" / "secondary")
getChannelHistory auto-joins channels on "not_in_channel" error, then retries — requires channels:join scope
If auto-join fails, throws a detailed message explaining how to invite the bot
searchMessages may require user token; bot token tried first
listChannels paginates via cursor; only first page is cached
getUserInfo resolves bots via getBotInfo when needed

---name: slackdescription: Search Slack messages and read channel history across your workspaces. Use this skill when the user asks about Slack conversations, channel messages, or internal communications.---# Slack Integration## Connection- **Base URL**: `https://slack.com/api/`- **Auth**: `Authorization: Bearer $SLACK_BOT_TOKEN` (or `$SLACK_BOT_TOKEN_2` for secondary workspace)- **Credentials**: `SLACK_BOT_TOKEN` (primary), `SLACK_BOT_TOKEN_2` (secondary workspace)- **Caching**: 2-minute in-memory cache, max 200 entries; separate user/bot caches## Server Lib- **File**: `server/lib/slack.ts`### Exported Functions| Function | Description || ---------------------------------------------------------- | -------------------------------------------- || `getTeamInfo(workspace)` | Get workspace info || `listChannels(workspace)` | List channels (paginated, first page cached) || `getChannelHistory(workspace, channelId, limit?, cursor?)` | Channel message history || `searchMessages(workspace, query, count?)` | Search messages || `getUserInfo(workspace, userId)` | Get user info (cached per user) || `getBotInfo(workspace, botId)` | Get bot info (cached) || `resolveUsers(workspace, userIds, messages?)` | Batch resolve user names |## Agent ActionUse `slack-messages` for agent-facing Slack reads. Do not call`/api/slack/*` directly from the agent.| Mode | Args | Description || --------------- | ---------------------------------------------------- | ---------------------- || `team` | `workspace` | Get workspace info || `channels` | `workspace` | List channels || `history` | `workspace`, `channel`, `limit`, `cursor` | Read channel history || `multi-history` | `workspace`, `channels`, `names`, `limit`, `cursors` | Read multiple channels || `search` | `workspace`, `query` | Search messages |## Key Patterns & Gotchas- Two workspaces supported via workspace parameter ("primary" / "secondary")- `getChannelHistory` auto-joins channels on "not_in_channel" error, then retries — requires `channels:join` scope- If auto-join fails, throws a detailed message explaining how to invite the bot- `searchMessages` may require user token; bot token tried first- `listChannels` paginates via cursor; only first page is cached- `getUserInfo` resolves bots via `getBotInfo` when needed

Frequently asked questions

Slack