From e3ce1ee10bf1f9323b29816feed6db7257b33a26 Mon Sep 17 00:00:00 2001
From: Claude <claude@firefrostgaming.com>
Date: Thu, 9 Apr 2026 15:03:22 +0000
Subject: [PATCH] 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
---
 docs/skills/discord-automation/SKILL.md | 177 ++++++++++++++++++++++++
 1 file changed, 177 insertions(+)
 create mode 100644 docs/skills/discord-automation/SKILL.md

diff --git a/docs/skills/discord-automation/SKILL.md b/docs/skills/discord-automation/SKILL.md
new file mode 100644
index 0000000..a69c2b1
--- /dev/null
+++ b/docs/skills/discord-automation/SKILL.md
@@ -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** 💙🔥❄️