discord-webhook_skill

Overview

This skill provides ready-to-use curl examples for sending messages, embeds, and files to Discord channels via webhooks. It lets you post notifications and rich content without creating a bot, using only a webhook URL and standard HTTP requests. Practical snippets cover simple text, embeds, attachments, mentions, silent messages, and CI/CD notifications.

How this skill works

You set a DISCORD_WEBHOOK_URL environment variable and send HTTP POST requests to that URL with JSON payloads or multipart form data. The skill supplies curl commands and payload templates for content, embeds, attachments, and mention controls. It also highlights limits and security practices (rate limits, message and file sizes) so you can integrate safely into scripts and pipelines.

When to use it

• Send real-time alerts from monitoring, CI/CD, or cron jobs
• Post build, deploy, or test results from automation pipelines
• Share images, logs, or screenshots as attachments
• Publish rich updates with embeds (titles, fields, colors, timestamps)
• Create lightweight integrations without managing a bot

Best practices

• Keep webhook URLs secret—treat them like passwords and rotate if leaked
• Respect rate limits: 30 requests per 60 seconds per webhook
• Use embeds for structured summaries and keep content under 2000 chars
• Attach files via multipart form and include payload_json for metadata
• Wrap curl calls that use environment variables in bash -c '...' when piping

Example use cases

• CI pipeline posts a build status embed with commit info and timestamp
• Monitoring script sends an error embed with service name and stack trace link
• Automated backup job uploads log files as attachments with a summary message
• Deployment script announces version and environment using a colored embed
• Ops team posts silent maintenance updates using the flags field to avoid notifications