feat: Add Discord webhook skill
Simple webhook-based notifications without needing a full bot: - Send messages, embeds, files to channels - Custom username/avatar per message - Rate limit: 30 requests per 60 seconds - Perfect for Arbiter alerts and CI/CD notifications Chronicler #70
This commit is contained in:
Claude
@@ -251,6 +251,7 @@ Skills encode standards into actionable workflows. Standards define what must be
|
||||
- `discord-manage-channel.md` — Update, move, configure permissions, delete channels
|
||||
- `discord-bot-api.md` — Direct curl commands for messages, roles, members, webhooks
|
||||
- `discord-automation-rube-mcp.md` — Higher-level automation via Composio/Rube MCP
|
||||
- `discord-webhook.md` — Simple webhook notifications without a bot
|
||||
|
||||
**Triggers:**
|
||||
- Creating Discord channels
|
||||
|
||||
@@ -76,3 +76,17 @@ Use **Discord Automation (Rube MCP)**:
|
||||
---
|
||||
|
||||
**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️
|
||||
|
||||
---
|
||||
|
||||
## Added April 8, 2026 — Discord Webhook Skill
|
||||
|
||||
**File:** `discord-webhook.md`
|
||||
|
||||
Simple webhook-based notifications without needing a full bot. Perfect for:
|
||||
- Arbiter alerts
|
||||
- CI/CD pipeline notifications
|
||||
- Server status updates
|
||||
- Error alerts
|
||||
|
||||
No bot token required — just a webhook URL from Discord server settings.
|
||||
|
||||
356
docs/skills/discord-automation/discord-webhook.md
Normal file
356
docs/skills/discord-automation/discord-webhook.md
Normal file
@@ -0,0 +1,356 @@
|
||||
---
|
||||
name: discord-webhook
|
||||
description: Discord Webhook API via curl. Use this skill to send messages, embeds, and files to Discord channels without a bot.
|
||||
vm0_secrets:
|
||||
- DISCORD_WEBHOOK_URL
|
||||
---
|
||||
|
||||
# Discord Webhook
|
||||
|
||||
Use Discord Webhooks via direct `curl` calls to **send messages to Discord channels** without setting up a bot.
|
||||
|
||||
> Official docs: `https://discord.com/developers/docs/resources/webhook`
|
||||
|
||||
---
|
||||
|
||||
## When to Use
|
||||
|
||||
Use this skill when you need to:
|
||||
|
||||
- **Send notifications** to Discord channels
|
||||
- **Post alerts** from CI/CD pipelines
|
||||
- **Share updates** with rich embeds
|
||||
- **Upload files** to channels
|
||||
- **Simple integrations** without bot complexity
|
||||
|
||||
---
|
||||
|
||||
## Prerequisites
|
||||
|
||||
1. In Discord, go to Server Settings → Integrations → Webhooks
|
||||
2. Click "New Webhook"
|
||||
3. Choose a name and target channel
|
||||
4. Click "Copy Webhook URL"
|
||||
|
||||
```bash
|
||||
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/1234567890/abcdefg..."
|
||||
```
|
||||
|
||||
**Security:** Never expose webhook URLs publicly - they require no authentication.
|
||||
|
||||
---
|
||||
|
||||
|
||||
> **Important:** When using `$VAR` in a command that pipes to another command, wrap the command containing `$VAR` in `bash -c '...'`. Due to a Claude Code bug, environment variables are silently cleared when pipes are used directly.
|
||||
> ```bash
|
||||
> bash -c 'curl -s "https://api.example.com" -H "Authorization: Bearer $API_KEY"'
|
||||
> ```
|
||||
|
||||
## How to Use
|
||||
|
||||
All examples below assume you have `DISCORD_WEBHOOK_URL` set.
|
||||
|
||||
---
|
||||
|
||||
### 1. Send Simple Message
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"content": "Hello from webhook!"
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Send with Custom Username and Avatar
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"content": "Alert!",
|
||||
"username": "Alert Bot",
|
||||
"avatar_url": "https://i.imgur.com/4M34hi2.png"
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. Send Rich Embed
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"embeds": [
|
||||
{
|
||||
"title": "Deployment Complete",
|
||||
"description": "Version 1.2.3 deployed to production",
|
||||
"color": 5763719,
|
||||
"fields": [
|
||||
{
|
||||
"name": "Environment",
|
||||
"value": "Production",
|
||||
"inline": true
|
||||
},
|
||||
{
|
||||
"name": "Status",
|
||||
"value": "Success",
|
||||
"inline": true
|
||||
}
|
||||
],
|
||||
"timestamp": "2025-01-01T12:00:00.000Z"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
**Common colors (decimal):**
|
||||
- Green: `5763719`
|
||||
- Red: `15548997`
|
||||
- Blue: `5793266`
|
||||
- Yellow: `16776960`
|
||||
- Orange: `16744192`
|
||||
|
||||
---
|
||||
|
||||
### 4. Send Error Alert
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"embeds": [
|
||||
{
|
||||
"title": "Error Alert",
|
||||
"description": "Database connection failed",
|
||||
"color": 15548997,
|
||||
"fields": [
|
||||
{
|
||||
"name": "Service",
|
||||
"value": "api-server"
|
||||
},
|
||||
{
|
||||
"name": "Error",
|
||||
"value": "Connection timeout"
|
||||
}
|
||||
],
|
||||
"footer": {
|
||||
"text": "Monitor"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. Send File Attachment
|
||||
|
||||
Write to `/tmp/discord_webhook_payload.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"content": "Screenshot attached"
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -F "file1=@screenshot.png" -F 'payload_json=@/tmp/discord_webhook_payload.json'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. Send Multiple Files
|
||||
|
||||
Write to `/tmp/discord_webhook_payload.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"content": "Log files attached"
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -F "file1=@error.log" -F "file2=@debug.log" -F 'payload_json=@/tmp/discord_webhook_payload.json'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. Send Multiple Embeds
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"embeds": [
|
||||
{
|
||||
"title": "Build Started",
|
||||
"color": 16776960
|
||||
},
|
||||
{
|
||||
"title": "Tests Passed",
|
||||
"color": 5763719
|
||||
},
|
||||
{
|
||||
"title": "Deployed",
|
||||
"color": 5793266
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 8. Send with Mention
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"content": "<@<your-user-id>> Check this out!",
|
||||
"allowed_mentions": {
|
||||
"users": ["<your-user-id>"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
Replace `<your-user-id>` with the actual Discord user ID.
|
||||
|
||||
---
|
||||
|
||||
### 9. Send Silent Message (No Notification)
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"content": "Silent update",
|
||||
"flags": 4096
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 10. CI/CD Pipeline Notification
|
||||
|
||||
Write to `/tmp/discord_webhook_request.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"username": "GitHub Actions",
|
||||
"embeds": [
|
||||
{
|
||||
"title": "Pipeline Status",
|
||||
"color": 5763719,
|
||||
"fields": [
|
||||
{
|
||||
"name": "Repository",
|
||||
"value": "myorg/myrepo",
|
||||
"inline": true
|
||||
},
|
||||
{
|
||||
"name": "Branch",
|
||||
"value": "main",
|
||||
"inline": true
|
||||
},
|
||||
{
|
||||
"name": "Commit",
|
||||
"value": "abc1234",
|
||||
"inline": true
|
||||
},
|
||||
{
|
||||
"name": "Status",
|
||||
"value": "Success"
|
||||
}
|
||||
],
|
||||
"timestamp": "2025-01-01T12:00:00.000Z"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
curl -s -X POST "${DISCORD_WEBHOOK_URL}" -H "Content-Type: application/json" -d @/tmp/discord_webhook_request.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Embed Structure
|
||||
|
||||
```json
|
||||
{
|
||||
"title": "Title text",
|
||||
"description": "Description text",
|
||||
"url": "https://example.com",
|
||||
"color": 5763719,
|
||||
"fields": [
|
||||
{"name": "Field 1", "value": "Value 1", "inline": true}
|
||||
],
|
||||
"author": {"name": "Author", "icon_url": "https://..."},
|
||||
"footer": {"text": "Footer text"},
|
||||
"thumbnail": {"url": "https://..."},
|
||||
"image": {"url": "https://..."},
|
||||
"timestamp": "2025-01-01T12:00:00.000Z"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Guidelines
|
||||
|
||||
1. **Rate limits**: 30 requests per 60 seconds per webhook
|
||||
2. **Message limit**: 2000 characters for content
|
||||
3. **Embed limits**: Max 10 embeds, 6000 total characters
|
||||
4. **File limits**: Max 8MB per file (50MB with Nitro boost)
|
||||
5. **Security**: Treat webhook URLs like passwords
|
||||
Reference in New Issue
Block a user