slack

# Slack Integration Read-only access to a Slack workspace via the Slack Web API. All scripts are in `scripts/` relative to this skill and use `@slack/web-api`. ## Setup The `SLACK_BOT_TOKEN` (or `SLACK_TOKEN`) environment variable must be set with a bot token that has the necessary scopes (channels:read, channels:history, groups:read, groups:history, users:read, search:read, etc.). Dependencies (`@slack/web-api`) are declared in the root `package.json`. Run `npm install` at the repo root if not already done. ## Available Scripts All scripts are `.mjs` files. Run them with `node <skill-path>/scripts/<script>.mjs`. ### search-messages.mjs Search across all messages in the workspace. Supports Slack search modifiers like `in:#channel`, `from:@user`, `before:`, `after:`, etc. ```bash node scripts/search-messages.mjs "deploy issue" node scripts/search-messages.mjs "in:#engineering bug" --count 5 node scripts/search-messages.mjs "from:@alice after:2025-01-01" --sort timestamp ``` ### channel-history.mjs Read recent messages from a channel. Accepts channel name or ID. ```bash node scripts/channel-history.mjs general --limit 30 node scripts/channel-history.mjs #engineering --oldest 2025-03-01 --limit 50 ``` ### thread-replies.mjs Read all replies in a thread. Use the `ts` (timestamp) from channel-history output. ```bash node scripts/thread-replies.mjs general 1234567890.123456 ``` ### list-channels.mjs List channels, optionally filtered by name pattern. ```bash node scripts/list-channels.mjs node scripts/list-channels.mjs --filter eng ``` ### channel-info.mjs Get details about a channel (purpose, topic, member count). ```bash node scripts/channel-info.mjs general ``` ### search-users.mjs Search users by name, display name, or email. ```bash node scripts/search-users.mjs john node scripts/search-users.mjs engineering ``` ## Workflow Patterns When the user asks something like "check #channel for discussion about X": 1. First try `search-messages.mjs "in:#channel X"` — this is fastest 2. If search doesn't find enough, use `channel-history.mjs` with date filters to browse recent messages 3. For threads with interesting context, use `thread-replies.mjs` to get the full conversation When the user asks "who works on X" or "find person Y": 1. Use `search-users.mjs` to find the person 2. Optionally use `search-messages.mjs "from:@username"` to see their recent activity When exploring a workspace: 1. `list-channels.mjs` to discover channels 2. `channel-info.mjs` to understand a channel's purpose 3. `channel-history.mjs` to read recent activity ## Tips - Slack search modifiers are powerful: `in:#channel`, `from:@user`, `has:link`, `has:reaction`, `before:YYYY-MM-DD`, `after:YYYY-MM-DD`, `during:month` - Channel names can be passed with or without the `#` prefix - Thread timestamps look like `1234567890.123456` — copy them from channel-history output - All scripts print human-readable output to stdout, so you can read and summarize the results directly