Slack Connect

Entry point for all Slack operations. Validates configuration, discovers workspace, and routes requests to appropriate skills.

Trigger Phrases

Load this skill when user says:

• •"slack" / "connect slack" / "slack connect"
• •"send slack message" / "message [channel]"
• •"list slack channels" / "slack channels"
• •"search slack" / "find in slack"
• •"slack users" / "who's on slack"
• •Any reference to Slack operations

Quick Reference

First-time setup:

python 00-system/skills/slack/slack-master/scripts/setup_slack.py

Check configuration:

python 00-system/skills/slack/slack-master/scripts/check_slack_config.py --json

Workflow

Step 1: Validate Configuration

Always run first:

python 00-system/skills/slack/slack-master/scripts/check_slack_config.py --json

If ai_action is proceed_with_operation:

• •Continue to Step 2

If ai_action is run_oauth_setup:

1. •Tell user: "Slack needs to be set up. Let me guide you through authorization."
2. •Run: python 00-system/skills/slack/slack-master/scripts/setup_slack.py
3. •After setup, re-check config

If ai_action is create_slack_app:

1. •Guide user through creating a Slack App
2. •Load: slack-master/references/setup-guide.md
3. •After app created, run setup wizard

Step 2: Identify User Intent

Parse what the user wants to do:

Step 3: Execute Operation

Use the appropriate script from slack-master/scripts/:

Messaging Operations

Send message:

python 00-system/skills/slack/slack-master/scripts/send_message.py \
  --channel "C1234567890" \
  --text "Hello from Nexus!" \
  --json

Update message:

python 00-system/skills/slack/slack-master/scripts/update_message.py \
  --channel "C1234567890" \
  --ts "1234567890.123456" \
  --text "Updated message" \
  --json

Delete message:

python 00-system/skills/slack/slack-master/scripts/delete_message.py \
  --channel "C1234567890" \
  --ts "1234567890.123456" \
  --json

Channel Operations

List channels:

python 00-system/skills/slack/slack-master/scripts/list_channels.py \
  --types "public_channel,private_channel" \
  --limit 50 \
  --json

Get channel info:

python 00-system/skills/slack/slack-master/scripts/channel_info.py \
  --channel "C1234567890" \
  --json

Get channel history:

python 00-system/skills/slack/slack-master/scripts/channel_history.py \
  --channel "C1234567890" \
  --limit 20 \
  --json

User Operations

List users:

python 00-system/skills/slack/slack-master/scripts/list_users.py \
  --limit 100 \
  --json

Get user info:

python 00-system/skills/slack/slack-master/scripts/user_info.py \
  --user "U1234567890" \
  --json

Search Operations

Search messages:

python 00-system/skills/slack/slack-master/scripts/search_messages.py \
  --query "project update" \
  --count 20 \
  --json

Search files:

python 00-system/skills/slack/slack-master/scripts/search_files.py \
  --query "report.pdf" \
  --count 10 \
  --json

File Operations

Upload file:

python 00-system/skills/slack/slack-master/scripts/upload_file.py \
  --file "/path/to/file.pdf" \
  --channels "C1234567890" \
  --title "My Report" \
  --json

List files:

python 00-system/skills/slack/slack-master/scripts/list_files.py \
  --channel "C1234567890" \
  --limit 20 \
  --json

Step 4: Handle Results

Success:

• •Display relevant information to user
• •Format output nicely (channel names, usernames, etc.)

Error:

• •Load slack-master/references/error-handling.md if needed
• •Common errors:
  • •channel_not_found → Help user find correct channel
  • •missing_scope → Need to add scope and re-authorize
  • •rate_limited → Wait and retry

Operation Scripts Reference

All scripts are in 00-system/skills/slack/slack-master/scripts/:

Messaging

Conversations

Users

Files

Search

Channel Resolution

When user references a channel by name (e.g., "#general"):

1. •

   First, list channels to find the ID:

   bash

   python list_channels.py --json
   

2. •

   Find matching channel in response

3. •

   Use the channel ID (e.g., "C1234567890") for operations

Common Pattern:

# User says: "send message to #general"
# 1. List channels to find ID
# 2. Use ID in send_message.py --channel C123...

User Resolution

When user references someone by name (e.g., "@john"):

1. •

   List users to find the ID:

   bash

   python list_users.py --json
   

2. •

   Find matching user in response

3. •

   Use the user ID (e.g., "U1234567890") for operations

Example Interactions

Send a Message

User: "Send 'Hello team!' to #general"

AI Actions:

1. •Check config: check_slack_config.py --json
2. •List channels: list_channels.py --json
3. •Find #general ID → C1234567890
4. •Send message: send_message.py --channel C1234567890 --text "Hello team!" --json
5. •Confirm to user: "Message sent to #general"

Search Slack

User: "Search slack for 'quarterly report'"

AI Actions:

1. •Check config
2. •Search: search_messages.py --query "quarterly report" --json
3. •Display results with channel names and snippets

List My Channels

User: "What slack channels am I in?"

AI Actions:

1. •Check config
2. •List: list_channels.py --types "public_channel,private_channel" --json
3. •Display channel names and member counts

Error Handling

Configuration Errors

Operation Errors

For detailed error handling:

Load: slack-master/references/error-handling.md

Related Resources

• •Setup: slack-master/references/setup-guide.md
• •API Reference: slack-master/references/api-reference.md
• •Authentication: slack-master/references/authentication.md
• •Errors: slack-master/references/error-handling.md

Version: 1.0 Created: 2025-12-17 Status: Production Ready