Slack App Setup

When to Use

USE THIS SKILL WHEN:

• The user says "set up Slack", "connect Slack", "add a Slack workspace", "get you on Slack", or any variant that means connect this assistant to Slack.
• A freshly-provisioned assistant needs a Slack bot identity (tokens, scopes, events) configured for the first time.
• The user wants to switch the assistant to a new Slack workspace or rotate its tokens.

DO NOT use this skill for runtime Slack operations (posting, reading channels, triage). That is the separate slack skill.

Step 1 — Check existing configuration

Run assistant credentials list --search slack_channel (via the bash tool). Scan the result for entries with service: slack_channel and note which of app_token, bot_token are present.

Then branch:

• If both ✅ → fully configured. Offer to show status or reconfigure. Stop here unless the user wants a reset.
• Otherwise → continue to Step 2.

✓ Checkpoint: You named which of app_token / bot_token are present before branching. Do not skip the assistant credentials list call and guess.

Step 2 — Open the setup wizard

Call ui_show with surface_type: "channel_setup" and data: { channel: "slack" }. This opens the Slack setup wizard in the side panel. The wizard is non-blocking — the tool returns immediately.

⚠️ CRITICAL: Tool call first, announcement second — in the same turn. Do not write any message that says the wizard is open (or is opening) until the ui_show call has returned success earlier in the same turn. A message claiming the wizard is open when the tool was never called shows the user an empty side panel.

After ui_show returns success, tell the user:

I've opened the Slack setup wizard in the side panel. It will walk you through creating a Slack app from a manifest and connecting it — complete the steps there. The wizard will auto-notify me when you close it. If you run into issues along the way, ask me in chat.

Hand-off notification (phones and narrow windows). On phone-sized clients the setup opens on the Contacts page instead of a side drawer, and completing it there cannot auto-notify. The client signals this with a hidden message like [User action on channel_setup surface: moved the slack setup to the Contacts page]. When you receive that hand-off notification, tell the user:

It looks like the setup opened on your Contacts page rather than a side panel — same steps, different spot. When you've finished, come back here and tell me, and I'll verify the connection.

and rely on their confirmation to trigger Step 3 (no wizard-closed notification will arrive).

If the ui_show call fails, do NOT send that message — tell the user the wizard could not be opened and troubleshoot (e.g. no connected client) before retrying.

✓ Checkpoint: The successful ui_show tool result appears earlier in this turn than your announcement. If it does not, the wizard is not open — make the call before claiming it is.