Slack Skill

Slack API integration skill. Provides Browser OAuth 2.0 authentication, message send/receive, and channel management.

Prerequisites

1. Create a Slack App

1. •Visit https://api.slack.com/apps
2. •"Create New App" > "From scratch"
3. •Enter App Name, select Workspace
4. •Navigate to "OAuth & Permissions"

2. Configure Redirect URL

On the OAuth & Permissions page, add to the Redirect URLs section:

http://localhost:8765/slack/oauth/callback

3. Configure OAuth Scopes

Add the following Bot Token Scopes:

• •chat:write - Send messages
• •channels:read - Public channel list
• •channels:history - Public channel history
• •groups:read - Private channel list
• •groups:history - Private channel history
• •im:write - Send DMs
• •users:read - User info

4. Save Credentials

Create the file C:\claude\json\slack_credentials.json.

Option A: Enter Bot Token directly (recommended - simpler)

{
  "bot_token": "xoxb-YOUR-BOT-TOKEN"
}

Copy the Bot Token from the Bot User OAuth Token at the top of the OAuth & Permissions page.

Option B: OAuth authentication (browser popup)

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}

Client ID/Secret are available on the "Basic Information" page.

5. Run Authentication

python -m lib.slack login

• •Bot Token method: Validates immediately and completes
• •OAuth method: Browser opens, Slack authenticates, and the token is saved automatically

Commands

Usage Examples

Send Message

# Send message to channel
python -m lib.slack send "#general" "Hello, world!"

# Reply in thread
python -m lib.slack send "C01234567" "Reply" --thread "1234567890.123456"

Read Messages

# Last 10 messages
python -m lib.slack history "#general" --limit 10

# Default 100
python -m lib.slack history "C01234567"

Channel List

# Public channels only
python -m lib.slack channels

# Include private
python -m lib.slack channels --private

Python API

from lib.slack import SlackClient, login, get_token

# Authenticate (one-time)
login()

# Create client
client = SlackClient()

# Send message
result = client.send_message("#general", "Hello!")
print(result.permalink)

# Read history
messages = client.get_history("#general", limit=10)
for msg in messages:
    print(f"{msg.user}: {msg.text}")

# Channel list
channels = client.list_channels(include_private=True)
for ch in channels:
    print(f"#{ch.name} ({ch.id})")

Claude Mandatory Execution Rules (MANDATORY)

When a Slack keyword is detected, Claude MUST automatically perform the following.

Step 1: Check Auth Status (always first)

cd C:\claude && python -m lib.slack status --json

Interpreting the result:

• •"authenticated": true, "valid": true → proceed to Step 2
• •"authenticated": false → guide the user to log in:
  code

  Slack authentication is required. Run the following command:
  python -m lib.slack login
  

Step 2: Run the Command for the Request

Step 3: Parse JSON Result and Respond

Parse the --json flag output and respond to the user in a readable format.

Example - channel list:

{"count": 5, "channels": [{"id": "C123", "name": "general", ...}]}

→ "There are 5 channels: #general, #random, ..."

Required Behavior (MUST)

Prohibited Behavior (NEVER)

Channel Analysis Workflow

When the user requests "Slack analysis" or "channel analysis":

# 1. Full channel list
cd C:\claude && python -m lib.slack channels --private --json

# 2. Recent messages per channel (e.g., top 3 channels)
python -m lib.slack history "C_channel_id_1" --limit 50 --json
python -m lib.slack history "C_channel_id_2" --limit 50 --json

# 3. Aggregate results and write an analysis report

Workflow (Legacy)

When the user makes a Slack-related request:

1. •Check token: run python -m lib.slack status --json
2. •If missing: guide with python -m lib.slack login
3. •If present: run requested action (with --json flag)
4. •Output result: parse JSON and respond in a readable form

Error Handling

File Locations

Rate Limits

Complies with Slack API 2026 Rate Limits:

• •chat.postMessage: 3s interval
• •conversations.history: 1.2s interval
• •conversations.list: 3s interval
• •users.info: 0.6s interval

Rate limiting is applied automatically.