slack
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.
Datos de origen
- Repositorio
- BuilderIO/agent-native
- Última actividad en el origen
- 8 de julio de 2026 a las 16:20
- Idioma detectado de SKILL.md
- inglés
- Estrellas
- 7449
- Forks
- 681
Opciones de instalación
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Revisa los archivos de origen
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Mostrando SKILL.md
SKILL.md
Instrucciones de origen · Vista previa de solo lectura- name
- slack
- description
- 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 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
Ver en GitHub