{"skill":{"slug":"discord","displayName":"Discord","summary":"Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.","description":"---\nname: discord\ndescription: Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.\n---\n\n# Discord Actions\n\n## Overview\n\nUse `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 Clawdbot.\n\n## Inputs to collect\n\n- For reactions: `channelId`, `messageId`, and an `emoji`.\n- For stickers/polls/sendMessage: a `to` target (`channel:<id>` or `user:<id>`). Optional `content` text.\n- Polls also need a `question` plus 2–10 `answers`.\n- For media: `mediaUrl` with `file:///path` for local files or `https://...` for remote.\n- For emoji uploads: `guildId`, `name`, `mediaUrl`, optional `roleIds` (limit 256KB, PNG/JPG/GIF).\n- For sticker uploads: `guildId`, `name`, `description`, `tags`, `mediaUrl` (limit 512KB, PNG/APNG/Lottie JSON).\n\nMessage context lines include `discord message id` and `channel` fields you can reuse directly.\n\n**Note:** `sendMessage` uses `to: \"channel:<id>\"` format, not `channelId`. Other actions like `react`, `readMessages`, `editMessage` use `channelId` directly.\n\n## Actions\n\n### React to a message\n\n```json\n{\n  \"action\": \"react\",\n  \"channelId\": \"123\",\n  \"messageId\": \"456\",\n  \"emoji\": \"✅\"\n}\n```\n\n### List reactions + users\n\n```json\n{\n  \"action\": \"reactions\",\n  \"channelId\": \"123\",\n  \"messageId\": \"456\",\n  \"limit\": 100\n}\n```\n\n### Send a sticker\n\n```json\n{\n  \"action\": \"sticker\",\n  \"to\": \"channel:123\",\n  \"stickerIds\": [\"9876543210\"],\n  \"content\": \"Nice work!\"\n}\n```\n\n- Up to 3 sticker IDs per message.\n- `to` can be `user:<id>` for DMs.\n\n### Upload a custom emoji\n\n```json\n{\n  \"action\": \"emojiUpload\",\n  \"guildId\": \"999\",\n  \"name\": \"party_blob\",\n  \"mediaUrl\": \"file:///tmp/party.png\",\n  \"roleIds\": [\"222\"]\n}\n```\n\n- Emoji images must be PNG/JPG/GIF and <= 256KB.\n- `roleIds` is optional; omit to make the emoji available to everyone.\n\n### Upload a sticker\n\n```json\n{\n  \"action\": \"stickerUpload\",\n  \"guildId\": \"999\",\n  \"name\": \"clawdbot_wave\",\n  \"description\": \"Clawdbot waving hello\",\n  \"tags\": \"👋\",\n  \"mediaUrl\": \"file:///tmp/wave.png\"\n}\n```\n\n- Stickers require `name`, `description`, and `tags`.\n- Uploads must be PNG/APNG/Lottie JSON and <= 512KB.\n\n### Create a poll\n\n```json\n{\n  \"action\": \"poll\",\n  \"to\": \"channel:123\",\n  \"question\": \"Lunch?\",\n  \"answers\": [\"Pizza\", \"Sushi\", \"Salad\"],\n  \"allowMultiselect\": false,\n  \"durationHours\": 24,\n  \"content\": \"Vote now\"\n}\n```\n\n- `durationHours` defaults to 24; max 32 days (768 hours).\n\n### Check bot permissions for a channel\n\n```json\n{\n  \"action\": \"permissions\",\n  \"channelId\": \"123\"\n}\n```\n\n## Ideas to try\n\n- React with ✅/⚠️ to mark status updates.\n- Post a quick poll for release decisions or meeting times.\n- Send celebratory stickers after successful deploys.\n- Upload new emojis/stickers for release moments.\n- Run weekly “priority check” polls in team channels.\n- DM stickers as acknowledgements when a user’s request is completed.\n\n## Action gating\n\nUse `discord.actions.*` to disable action groups:\n- `reactions` (react + reactions list + emojiList)\n- `stickers`, `polls`, `permissions`, `messages`, `threads`, `pins`, `search`\n- `emojiUploads`, `stickerUploads`\n- `memberInfo`, `roleInfo`, `channelInfo`, `voiceStatus`, `events`\n- `roles` (role add/remove, default `false`)\n- `moderation` (timeout/kick/ban, default `false`)\n### Read recent messages\n\n```json\n{\n  \"action\": \"readMessages\",\n  \"channelId\": \"123\",\n  \"limit\": 20\n}\n```\n\n### Send/edit/delete a message\n\n```json\n{\n  \"action\": \"sendMessage\",\n  \"to\": \"channel:123\",\n  \"content\": \"Hello from Clawdbot\"\n}\n```\n\n**With media attachment:**\n\n```json\n{\n  \"action\": \"sendMessage\",\n  \"to\": \"channel:123\",\n  \"content\": \"Check out this audio!\",\n  \"mediaUrl\": \"file:///tmp/audio.mp3\"\n}\n```\n\n- `to` uses format `channel:<id>` or `user:<id>` for DMs (not `channelId`!)\n- `mediaUrl` supports local files (`file:///path/to/file`) and remote URLs (`https://...`)\n- Optional `replyTo` with a message ID to reply to a specific message\n\n```json\n{\n  \"action\": \"editMessage\",\n  \"channelId\": \"123\",\n  \"messageId\": \"456\",\n  \"content\": \"Fixed typo\"\n}\n```\n\n```json\n{\n  \"action\": \"deleteMessage\",\n  \"channelId\": \"123\",\n  \"messageId\": \"456\"\n}\n```\n\n### Threads\n\n```json\n{\n  \"action\": \"threadCreate\",\n  \"channelId\": \"123\",\n  \"name\": \"Bug triage\",\n  \"messageId\": \"456\"\n}\n```\n\n```json\n{\n  \"action\": \"threadList\",\n  \"guildId\": \"999\"\n}\n```\n\n```json\n{\n  \"action\": \"threadReply\",\n  \"channelId\": \"777\",\n  \"content\": \"Replying in thread\"\n}\n```\n\n### Pins\n\n```json\n{\n  \"action\": \"pinMessage\",\n  \"channelId\": \"123\",\n  \"messageId\": \"456\"\n}\n```\n\n```json\n{\n  \"action\": \"listPins\",\n  \"channelId\": \"123\"\n}\n```\n\n### Search messages\n\n```json\n{\n  \"action\": \"searchMessages\",\n  \"guildId\": \"999\",\n  \"content\": \"release notes\",\n  \"channelIds\": [\"123\", \"456\"],\n  \"limit\": 10\n}\n```\n\n### Member + role info\n\n```json\n{\n  \"action\": \"memberInfo\",\n  \"guildId\": \"999\",\n  \"userId\": \"111\"\n}\n```\n\n```json\n{\n  \"action\": \"roleInfo\",\n  \"guildId\": \"999\"\n}\n```\n\n### List available custom emojis\n\n```json\n{\n  \"action\": \"emojiList\",\n  \"guildId\": \"999\"\n}\n```\n\n### Role changes (disabled by default)\n\n```json\n{\n  \"action\": \"roleAdd\",\n  \"guildId\": \"999\",\n  \"userId\": \"111\",\n  \"roleId\": \"222\"\n}\n```\n\n### Channel info\n\n```json\n{\n  \"action\": \"channelInfo\",\n  \"channelId\": \"123\"\n}\n```\n\n```json\n{\n  \"action\": \"channelList\",\n  \"guildId\": \"999\"\n}\n```\n\n### Voice status\n\n```json\n{\n  \"action\": \"voiceStatus\",\n  \"guildId\": \"999\",\n  \"userId\": \"111\"\n}\n```\n\n### Scheduled events\n\n```json\n{\n  \"action\": \"eventList\",\n  \"guildId\": \"999\"\n}\n```\n\n### Moderation (disabled by default)\n\n```json\n{\n  \"action\": \"timeout\",\n  \"guildId\": \"999\",\n  \"userId\": \"111\",\n  \"durationMinutes\": 10\n}\n```\n\n## Discord Writing Style Guide\n\n**Keep it conversational!** Discord is a chat platform, not documentation.\n\n### Do\n- Short, punchy messages (1-3 sentences ideal)\n- Multiple quick replies > one wall of text\n- Use emoji for tone/emphasis 🦞\n- Lowercase casual style is fine\n- Break up info into digestible chunks\n- Match the energy of the conversation\n\n### Don't\n- No markdown tables (Discord renders them as ugly raw `| text |`)\n- No `## Headers` for casual chat (use **bold** or CAPS for emphasis)\n- Avoid multi-paragraph essays\n- Don't over-explain simple things\n- Skip the \"I'd be happy to help!\" fluff\n\n### Formatting that works\n- **bold** for emphasis\n- `code` for technical terms\n- Lists for multiple items\n- > quotes for referencing\n- Wrap multiple links in `<>` to suppress embeds\n\n### Example transformations\n\n❌ Bad:\n```\nI'd be happy to help with that! Here's a comprehensive overview of the versioning strategies available:\n\n## Semantic Versioning\nSemver uses MAJOR.MINOR.PATCH format where...\n\n## Calendar Versioning\nCalVer uses date-based versions like...\n```\n\n✅ Good:\n```\nversioning options: semver (1.2.3), calver (2026.01.04), or yolo (`latest` forever). what fits your release cadence?\n```\n","tags":{"latest":"1.0.1"},"stats":{"comments":4,"downloads":37901,"installsAllTime":1322,"installsCurrent":1319,"stars":78,"versions":2},"createdAt":1767545311074,"updatedAt":1779135045551},"latestVersion":{"version":"1.0.1","createdAt":1767574303488,"changelog":"","license":null},"metadata":null,"owner":{"handle":"steipete","userId":"s179zksw999xz8ms4cy7pb2fr183m5jq","displayName":"Peter Steinberger","image":"https://avatars.githubusercontent.com/u/58493?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779909604640}}