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:
Claude
2026-04-09 15:03:22 +00:00
parent cf028606d6
commit e3ce1ee10b

View 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** 💙🔥❄️