add-slack

Add Slack Channel

This skill adds Slack support to your assistant, then walks through interactive setup.

Phase 1: Pre-flight

Check if already applied

Check if src/channels/slack.ts exists. If it does, skip to Phase 3 (Setup). The code changes are already in place.

Ask the user

Do they already have a Slack app configured? If yes, collect the Bot Token and App Token now. If no, we'll create one in Phase 3.

Phase 2: Apply Code Changes

Ensure channel remote

git remote -v

If slack is missing, add it:

git remote add slack https://github.com/qwibitai/salem-slack.git

Merge the skill branch

git fetch slack main
git merge slack/main || {
  git checkout --theirs package-lock.json
  git add package-lock.json
  git merge --continue
}

This merges in:

• src/channels/slack.ts (SlackChannel class with self-registration via registerChannel)
• src/channels/slack.test.ts (46 unit tests)
• import './slack.js' appended to the channel barrel file src/channels/index.ts
• @slack/bolt npm dependency in package.json
• SLACK_BOT_TOKEN and SLACK_APP_TOKEN in .env.example

If the merge reports conflicts, resolve them by reading the conflicted files and understanding the intent of both sides.

Validate code changes

npm install
npm run build
npx vitest run src/channels/slack.test.ts

All tests must pass (including the new Slack tests) and build must be clean before proceeding.

Phase 3: Setup

Create Slack App (if needed)

If the user doesn't have a Slack app, share SLACK_SETUP.md which has step-by-step instructions with screenshots guidance, troubleshooting, and a token reference table.

Quick summary of what's needed:

1. Create a Slack app at api.slack.com/apps
2. Enable Socket Mode and generate an App-Level Token (xapp-...)
3. Subscribe to bot events: message.channels, message.groups, message.im
4. Add OAuth scopes: chat:write, channels:history, groups:history, im:history, channels:read, groups:read, users:read
5. Install to workspace and copy the Bot Token (xoxb-...)