send-slack-notification

Send Slack Notification

This skill sends a rich message to a Slack channel using the Slack API with Block Kit formatting.

Pre-flight Check

1. Run echo $SLACK_BOT_TOKEN in Bash
2. If empty or not starting with xoxb-, tell the user:

   SLACK_BOT_TOKEN is not set. Run /setup-slack-notifications first to configure your Slack bot token.
   

   Then stop — do not proceed.

---

Gather Message Details

Check if the user provided a message and channel inline (e.g. /send-slack #general Here's the update). If they did, parse it and skip the questions.

If not, use AskUserQuestion to gather details:

{
  "questions": [
    {
      "question": "Which Slack channel should the message go to?",
      "header": "Channel",
      "options": [
        {"label": "#general", "description": "The default general channel"},
        {"label": "#engineering", "description": "Engineering team channel"},
        {"label": "#random", "description": "The random channel"}
      ],
      "multiSelect": false
    },
    {
      "question": "What type of message do you want to send?",
      "header": "Format",
      "options": [
        {"label": "Text message (Recommended)", "description": "Simple rich text with markdown formatting"},
        {"label": "Status update", "description": "Header + body with context footer — great for progress updates"},
        {"label": "Code snippet", "description": "Formatted code block with optional description"},
        {"label": "Custom blocks", "description": "I'll describe the layout and you build the Block Kit JSON"}
      ],
      "multiSelect": false
    }
  ]
}

The user may select "Other" for the channel to type a custom channel name. Strip the # prefix if they include it.

Then ask the user for the actual message content in a follow-up chat message (not via AskUserQuestion — just ask them to type it).

---

Message Templates

Based on the format choice, build the appropriate Block Kit payload.

Text Message