setup-slack-notifications

Setup Slack Notifications

This skill walks you through configuring a Slack bot token so you can send rich notifications from Claude Code.

Pre-flight Check

Before starting the wizard, check if the token is already configured:

1. Run echo $SLACK_BOT_TOKEN in Bash to check if it's set
2. If it starts with xoxb-, the token is already configured. Verify it works:

curl -s -X POST https://slack.com/api/auth.test \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" | jq .

1. If "ok": true, tell the user their token is valid and show the workspace/bot name. Done.
2. If not set or invalid, proceed with the setup wizard below.

---

Setup Wizard

Use the AskUserQuestion tool with this single question to determine the user's starting point:

{
  "questions": [
    {
      "question": "Where are you in the Slack bot setup process?",
      "header": "Setup stage",
      "options": [
        {"label": "Start from scratch", "description": "I need to create a Slack app and get a bot token"},
        {"label": "I have a token already", "description": "I already have a xoxb-... bot token ready to configure"},
        {"label": "Check my setup", "description": "I think it's configured, just verify it works"}
      ],
      "multiSelect": false
    }
  ]
}

---

Path: Start from scratch

Walk the user through these steps. Present them as numbered instructions (not automated — the user does these in their browser):

Step 1 — Create a Slack App

Tell the user:

1. Go to https://api.slack.com/apps
2. Click "Create New App" → "From scratch"
3. Name it whatever you like (e.g. "Claude Notifier")
4. Select your workspace
5. Click "Create App"

Step 2 — Add Bot Token Scopes

Tell the user:

6. In the left sidebar, click "OAuth & Permissions"
7. Scroll down to "Scopes" → "Bot Token Scopes"
8. Click "Add an OAuth Scope" and add these two scopes:
   - chat:write        (send messages to channels the bot is in)
   - chat:write.public (send messages to any public channel)