slack-webhook_skill

Overview

This skill sends messages to a Slack channel using Incoming Webhooks. It provides a lightweight, one-way integration that requires no OAuth or bot setup. Use it to push alerts, CI/CD updates, or simple notifications to a fixed channel quickly.

How this skill works

The skill posts a JSON payload to a preconfigured Slack Incoming Webhook URL using curl or a similar HTTP client. It supports simple text, Slack formatting, links, emoji, and Block Kit payloads by sending the appropriate JSON body to the webhook. Environment variables should be used to store the webhook URL and shell escaping/here-documents help avoid history expansion or variable-clearing issues when piping commands.

When to use it

• Send notifications or alerts to a single, dedicated Slack channel
• CI/CD pipelines that need simple status messages without full app auth
• Quick integrations where creating a full Slack app or bot is unnecessary
• Posting formatted messages or Block Kit blocks from scripts
• Lightweight uptime or deployment notifications from servers or cron jobs

Best practices

• Keep the webhook URL in an environment variable (e.g., SLACK_WEBHOOK_URL) and never commit it to source control
• Use JSON files or here-documents to build payloads when they include special characters or newlines
• Respect the rate limit (about 1 message per second) and batch or debounce frequent events
• Validate JSON payloads to avoid invalid_payload errors and include a text field for basic compatibility
• Configure username and icon in the Incoming Webhook app settings instead of trying to override them in payloads

Example use cases

• Post a deployment summary with status fields and a link to release notes using Block Kit
• Send CI build success/failure messages from a pipeline step to a monitoring channel
• Notify on-critical alerts (CPU, memory, or service errors) from a server script
• Publish scheduled reports or digest messages from cron jobs using formatted text
• Send a simple hello or test message to verify webhook configuration