Slack Connect

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:

   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:

   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