docs(skills): Add consolidated discord-automation SKILL.md
Created single entry-point skill file with: - Quick reference table - Firefrost Discord credentials and channel IDs - Common operations (create channel, send message, embeds, permissions) - Firefrost embed colors - Permission numbers reference Links to detailed sub-files for complex operations. Chronicler #73
This commit is contained in:
177
docs/skills/discord-automation/SKILL.md
Normal file
177
docs/skills/discord-automation/SKILL.md
Normal file
@@ -0,0 +1,177 @@
|
||||
---
|
||||
name: discord-automation
|
||||
description: |
|
||||
Comprehensive Discord server management via API. Use this skill whenever:
|
||||
- Creating, updating, or deleting Discord channels (text, voice, announcement, category, stage)
|
||||
- Managing channel permissions and settings
|
||||
- Sending messages or embeds to channels
|
||||
- Working with Discord roles (create, assign, delete)
|
||||
- Setting up webhooks for notifications
|
||||
- Reacting to messages or managing reactions
|
||||
- Automating Discord server operations
|
||||
- Any Discord API interaction via curl or Rube MCP
|
||||
This skill covers direct curl commands AND higher-level Rube MCP automation.
|
||||
---
|
||||
|
||||
# Discord Automation Skill
|
||||
|
||||
Complete Discord server management for Firefrost Gaming via API.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 QUICK REFERENCE
|
||||
|
||||
| Task | Method | File |
|
||||
|------|--------|------|
|
||||
| Create channels | curl | `discord-create-channel.md` |
|
||||
| Update/delete channels | curl | `discord-manage-channel.md` |
|
||||
| Messages, embeds, reactions | curl | `discord-bot-api.md` |
|
||||
| Webhooks (no bot needed) | curl | `discord-webhook.md` |
|
||||
| Roles, DMs, complex flows | Rube MCP | `discord-automation-rube-mcp.md` |
|
||||
|
||||
---
|
||||
|
||||
## 🔑 FIREFROST DISCORD CREDENTIALS
|
||||
|
||||
```bash
|
||||
DISCORD_BOT_TOKEN=MTQ4NzA4MDE2Njk2OTU3NzUwMg.GU5EsT.mqBwo7XUHsciN9jNy9OygTRkaMZ9qJ2tHw7HbI
|
||||
GUILD_ID=1260574715546701936
|
||||
DISCORD_CLIENT_ID=1487080166969577502
|
||||
```
|
||||
|
||||
### Key Channel IDs
|
||||
|
||||
| Channel | ID |
|
||||
|---------|-----|
|
||||
| general-chat | 1260574716058664962 |
|
||||
| announcements | 1403980849686515832 |
|
||||
| 📚-guides (forum) | 1491804184356454430 |
|
||||
|
||||
---
|
||||
|
||||
## 📢 CHANNEL TYPES
|
||||
|
||||
| Type | Number | Use |
|
||||
|------|--------|-----|
|
||||
| Text | 0 | Regular text channels |
|
||||
| Voice | 2 | Voice chat |
|
||||
| Category | 4 | Folder for organizing channels |
|
||||
| Announcement | 5 | Crosspost to following servers |
|
||||
| Stage | 13 | Audio events |
|
||||
| Forum | 15 | Thread-based discussions |
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ COMMON OPERATIONS
|
||||
|
||||
### Create a Text Channel
|
||||
|
||||
```bash
|
||||
curl -X POST "https://discord.com/api/v10/guilds/${GUILD_ID}/channels" \
|
||||
-H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"name": "channel-name",
|
||||
"type": 0,
|
||||
"parent_id": "CATEGORY_ID"
|
||||
}'
|
||||
```
|
||||
|
||||
### Send a Message
|
||||
|
||||
```bash
|
||||
curl -X POST "https://discord.com/api/v10/channels/${CHANNEL_ID}/messages" \
|
||||
-H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"content": "Hello from the API!"}'
|
||||
```
|
||||
|
||||
### Send an Embed
|
||||
|
||||
```bash
|
||||
curl -X POST "https://discord.com/api/v10/channels/${CHANNEL_ID}/messages" \
|
||||
-H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"embeds": [{
|
||||
"title": "Title Here",
|
||||
"description": "Description here",
|
||||
"color": 5765099,
|
||||
"fields": [
|
||||
{"name": "Field 1", "value": "Value 1", "inline": true}
|
||||
]
|
||||
}]
|
||||
}'
|
||||
```
|
||||
|
||||
### Update Channel Permissions
|
||||
|
||||
```bash
|
||||
curl -X PUT "https://discord.com/api/v10/channels/${CHANNEL_ID}/permissions/${ROLE_ID}" \
|
||||
-H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"type": 0,
|
||||
"allow": "1024",
|
||||
"deny": "0"
|
||||
}'
|
||||
```
|
||||
|
||||
### Delete a Channel
|
||||
|
||||
```bash
|
||||
curl -X DELETE "https://discord.com/api/v10/channels/${CHANNEL_ID}" \
|
||||
-H "Authorization: Bot ${DISCORD_BOT_TOKEN}"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 FIREFROST EMBED COLORS
|
||||
|
||||
| Color | Hex | Decimal |
|
||||
|-------|-----|---------|
|
||||
| Fire | #FF6B35 | 16738101 |
|
||||
| Frost | #4ECDC4 | 5164484 |
|
||||
| Arcane | #A855F7 | 11031031 |
|
||||
| Gold | #FFD700 | 16766720 |
|
||||
| Dark | #0F0F1E | 986910 |
|
||||
|
||||
---
|
||||
|
||||
## 📁 DETAILED DOCUMENTATION
|
||||
|
||||
For complex operations, see the individual files in this skill folder:
|
||||
|
||||
- **discord-create-channel.md** — All channel creation options, categories, permissions
|
||||
- **discord-manage-channel.md** — Update, move, configure, delete channels
|
||||
- **discord-bot-api.md** — Full bot API reference (messages, roles, members)
|
||||
- **discord-webhook.md** — Simple webhooks (no bot token needed)
|
||||
- **discord-automation-rube-mcp.md** — Rube MCP integration for complex workflows
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ PERMISSION NUMBERS
|
||||
|
||||
Common permission flags (bitwise):
|
||||
|
||||
| Permission | Value |
|
||||
|------------|-------|
|
||||
| View Channel | 1024 |
|
||||
| Send Messages | 2048 |
|
||||
| Manage Messages | 8192 |
|
||||
| Manage Channels | 16 |
|
||||
| Manage Roles | 268435456 |
|
||||
|
||||
Combine with OR: `View + Send = 1024 | 2048 = 3072`
|
||||
|
||||
---
|
||||
|
||||
## 🔗 RESOURCES
|
||||
|
||||
- [Discord Developer Portal](https://discord.com/developers/applications)
|
||||
- [Discord API Docs](https://discord.com/developers/docs)
|
||||
- [Permission Calculator](https://discordapi.com/permissions.html)
|
||||
|
||||
---
|
||||
|
||||
**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️
|
||||
Reference in New Issue
Block a user