slack-connect_skill

Overview

This skill connects to a Slack workspace to validate configuration, discover workspaces and channels, and route user requests to the correct Slack operation. It acts as the entry point for messaging, channel management, user lookups, file uploads, and search. It guides setup when authorization or app configuration is missing.

How this skill works

On trigger, the skill first runs a configuration check to determine whether to proceed, run the OAuth setup wizard, or prompt app creation. It parses user intent (send message, list channels, search messages, list users, upload file, etc.), resolves channel and user names to IDs, and dispatches the request to the appropriate operation script. It captures results, formats user-friendly output, and surfaces actionable error guidance when operations fail.

When to use it

• Send or update messages in a channel or direct message
• List or inspect channels and channel history
• Search messages or files across the workspace
• List users or get user details
• Upload files, add reactions, or manage pins and reminders

Best practices

• Always run the configuration check before any operation to detect missing credentials or scopes
• When referencing channels or users by name, resolve names to IDs first to avoid channel_not_found or user resolution errors
• If missing scopes or invalid tokens are reported, follow the authorization flow and re-check configuration
• Handle rate limits by respecting retry_after and reattempting operations later
• Present clear channel names, timestamps, and username context when returning results to users

Example use cases

• Send a message: validate config, resolve #general to its ID, call the send message operation, confirm success
• List channels you're a member of and show member counts and types
• Search Slack for "quarterly report" and return matched messages with channel snippets
• Upload a file to a channel with title and confirm the file URL
• List workspace users and retrieve a specific user's profile details