Use when you need to control Discord from Sky via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, create/edit/delete channels and categories, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
Use discord to manage messages, reactions, threads, polls, and moderation. You can disable groups via discord.actions.* (defaults to enabled, except roles/moderation). The tool uses the bot token configured for Sky.
channelId, messageId, and an emoji.guildId, channelId, messageId, or a messageLink like https://discord.com/channels/<guildId>/<channelId>/<messageId>.to target (channel:<id> or user:<id>). Optional content text.question plus 2–10 answers.mediaUrl with file:///path for local files or for remote.https://...guildId, name, mediaUrl, optional roleIds (limit 256KB, PNG/JPG/GIF).guildId, name, description, tags, mediaUrl (limit 512KB, PNG/APNG/Lottie JSON).Message context lines include discord message id and channel fields you can reuse directly.
Note: sendMessage uses to: "channel:<id>" format, not channelId. Other actions like react, readMessages, editMessage use channelId directly.
Note: fetchMessage accepts message IDs or full links like https://discord.com/channels/<guildId>/<channelId>/<messageId>.
{
"action": "react",
"channelId": "123",
"messageId": "456",
"emoji": "✅"
}
{
"action": "reactions",
"channelId": "123",
"messageId": "456",
"limit": 100
}
{
"action": "sticker",
"to": "channel:123",
"stickerIds": ["9876543210"],
"content": "Nice work!"
}
to can be user:<id> for DMs.{
"action": "emojiUpload",
"guildId": "999",
"name": "party_blob",
"mediaUrl": "file:///tmp/party.png",
"roleIds": ["222"]
}
roleIds is optional; omit to make the emoji available to everyone.{
"action": "stickerUpload",
"guildId": "999",
"name": "sky_wave",
"description": "Sky waving hello",
"tags": "👋",
"mediaUrl": "file:///tmp/wave.png"
}
name, description, and tags.{
"action": "poll",
"to": "channel:123",
"question": "Lunch?",
"answers": ["Pizza", "Sushi", "Salad"],
"allowMultiselect": false,
"durationHours": 24,
"content": "Vote now"
}
durationHours defaults to 24; max 32 days (768 hours).{
"action": "permissions",
"channelId": "123"
}
Use discord.actions.* to disable action groups:
reactions (react + reactions list + emojiList)stickers, polls, permissions, messages, threads, pins, searchemojiUploads, stickerUploadsmemberInfo, roleInfo, channelInfo, voiceStatus, eventsroles (role add/remove, default false)channels (channel/category create/edit/delete/move, default false)moderation (timeout/kick/ban, default false){
"action": "readMessages",
"channelId": "123",
"limit": 20
}
{
"action": "fetchMessage",
"guildId": "999",
"channelId": "123",
"messageId": "456"
}
{
"action": "fetchMessage",
"messageLink": "https://discord.com/channels/999/123/456"
}
{
"action": "sendMessage",
"to": "channel:123",
"content": "Hello from Sky"
}
With media attachment:
{
"action": "sendMessage",
"to": "channel:123",
"content": "Check out this audio!",
"mediaUrl": "file:///tmp/audio.mp3"
}
to uses format channel:<id> or user:<id> for DMs (not channelId!)mediaUrl supports local files (file:///path/to/file) and remote URLs (https://...)replyTo with a message ID to reply to a specific message{
"action": "editMessage",
"channelId": "123",
"messageId": "456",
"content": "Fixed typo"
}
{
"action": "deleteMessage",
"channelId": "123",
"messageId": "456"
}
{
"action": "threadCreate",
"channelId": "123",
"name": "Bug triage",
"messageId": "456"
}
{
"action": "threadList",
"guildId": "999"
}
{
"action": "threadReply",
"channelId": "777",
"content": "Replying in thread"
}
{
"action": "pinMessage",
"channelId": "123",
"messageId": "456"
}
{
"action": "listPins",
"channelId": "123"
}
{
"action": "searchMessages",
"guildId": "999",
"content": "release notes",
"channelIds": ["123", "456"],
"limit": 10
}
{
"action": "memberInfo",
"guildId": "999",
"userId": "111"
}
{
"action": "roleInfo",
"guildId": "999"
}
{
"action": "emojiList",
"guildId": "999"
}
{
"action": "roleAdd",
"guildId": "999",
"userId": "111",
"roleId": "222"
}
{
"action": "channelInfo",
"channelId": "123"
}
{
"action": "channelList",
"guildId": "999"
}
Create, edit, delete, and move channels and categories. Enable via discord.actions.channels: true.
Create a text channel:
{
"action": "channelCreate",
"guildId": "999",
"name": "general-chat",
"type": 0,
"parentId": "888",
"topic": "General discussion"
}
type: Discord channel type integer (0 = text, 2 = voice, 4 = category; other values supported)parentId: category ID to nest under (optional)topic, position, nsfw: optionalCreate a category:
{
"action": "categoryCreate",
"guildId": "999",
"name": "Projects"
}
Edit a channel:
{
"action": "channelEdit",
"channelId": "123",
"name": "new-name",
"topic": "Updated topic"
}
name, topic, position, parentId (null to remove from category), nsfw, rateLimitPerUserMove a channel:
{
"action": "channelMove",
"guildId": "999",
"channelId": "123",
"parentId": "888",
"position": 2
}
parentId: target category (null to move to top level)Delete a channel:
{
"action": "channelDelete",
"channelId": "123"
}
Edit/delete a category:
{
"action": "categoryEdit",
"categoryId": "888",
"name": "Renamed Category"
}
{
"action": "categoryDelete",
"categoryId": "888"
}
{
"action": "voiceStatus",
"guildId": "999",
"userId": "111"
}
{
"action": "eventList",
"guildId": "999"
}
{
"action": "timeout",
"guildId": "999",
"userId": "111",
"durationMinutes": 10
}
Keep it conversational! Discord is a chat platform, not documentation.
| text |)## Headers for casual chat (use bold or CAPS for emphasis)code for technical termsquotes for referencing
<> to suppress embeds❌ Bad:
I'd be happy to help with that! Here's a comprehensive overview of the versioning strategies available:
## Semantic Versioning
Semver uses MAJOR.MINOR.PATCH format where...
## Calendar Versioning
CalVer uses date-based versions like...
✅ Good:
versioning options: semver (1.2.3), calver (2026.01.04), or yolo (`latest` forever). what fits your release cadence?