Agent skill

Discord

by CraftOS-dev in CraftOS-dev/CraftBot

A skill your agent uses 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…

MITAuto-check passedMedia & Creative

Install Discord

skills CLI
$ npx skills add CraftOS-dev/CraftBot --skill discord -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install CraftOS-dev/CraftBot discord --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/discord .claude/skills/discord && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
discord
GitHub stars
392
Used in
2 other repos
Token cost
~1.8k tokens
SKILL.md length
473 words
Files
3
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses 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…

  • You need to control Discord from Clawdbot via the discord tool: send messages
  • SKILL.md covers Overview, Inputs to collect, Actions and Ideas to try, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Upload stickers

What it does

Discord is an agent skill from CraftOS-dev/CraftBot. 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.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `.clawhub/origin.json` and `_meta.json`).

It sits in Media & Creative, covering Social media graphics and Messaging and chat bots. It works with Discord and React. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

  • You need to control Discord from Clawdbot via the discord tool: send messages
  • Upload stickers
  • Manage threads/pins/search
  • Fetch permissions

Example prompts

  • “/discord”

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Discord loads about 1.8k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 473 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 473 words, ~1,781 tokens.

Download SKILL.mdSave it as .claude/skills/discord/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
discord
description
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.

Discord Actions

Overview

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 Clawdbot.

Inputs to collect

  • For reactions: channelId, messageId, and an emoji.
  • For stickers/polls/sendMessage: a to target (channel:<id> or user:<id>). Optional content text.
  • Polls also need a question plus 2–10 answers.
  • For media: mediaUrl with file:///path for local files or https://... for remote.
  • For emoji uploads: guildId, name, mediaUrl, optional roleIds (limit 256KB, PNG/JPG/GIF).
  • For sticker uploads: 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.

Actions

React to a message
json
{
  "action": "react",
  "channelId": "123",
  "messageId": "456",
  "emoji": "✅"
}
List reactions + users
json
{
  "action": "reactions",
  "channelId": "123",
  "messageId": "456",
  "limit": 100
}
Send a sticker
json
{
  "action": "sticker",
  "to": "channel:123",
  "stickerIds": ["9876543210"],
  "content": "Nice work!"
}
  • Up to 3 sticker IDs per message.
  • to can be user:<id> for DMs.
Upload a custom emoji
json
{
  "action": "emojiUpload",
  "guildId": "999",
  "name": "party_blob",
  "mediaUrl": "file:///tmp/party.png",
  "roleIds": ["222"]
}
  • Emoji images must be PNG/JPG/GIF and <= 256KB.
  • roleIds is optional; omit to make the emoji available to everyone.
Upload a sticker
json
{
  "action": "stickerUpload",
  "guildId": "999",
  "name": "clawdbot_wave",
  "description": "Clawdbot waving hello",
  "tags": "👋",
  "mediaUrl": "file:///tmp/wave.png"
}
  • Stickers require name, description, and tags.
  • Uploads must be PNG/APNG/Lottie JSON and <= 512KB.
Create a poll
json
{
  "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).
Check bot permissions for a channel
json
{
  "action": "permissions",
  "channelId": "123"
}

Ideas to try

  • React with ✅/⚠️ to mark status updates.
  • Post a quick poll for release decisions or meeting times.
  • Send celebratory stickers after successful deploys.
  • Upload new emojis/stickers for release moments.
  • Run weekly “priority check” polls in team channels.
  • DM stickers as acknowledgements when a user’s request is completed.

Action gating

Use discord.actions.* to disable action groups:

  • reactions (react + reactions list + emojiList)
  • stickers, polls, permissions, messages, threads, pins, search
  • emojiUploads, stickerUploads
  • memberInfo, roleInfo, channelInfo, voiceStatus, events
  • roles (role add/remove, default false)
  • moderation (timeout/kick/ban, default false)
Show full SKILL.md (180 more words)Show less
Read recent messages
json
{
  "action": "readMessages",
  "channelId": "123",
  "limit": 20
}
Send/edit/delete a message
json
{
  "action": "sendMessage",
  "to": "channel:123",
  "content": "Hello from Clawdbot"
}

With media attachment:

json
{
  "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://...)
  • Optional replyTo with a message ID to reply to a specific message
json
{
  "action": "editMessage",
  "channelId": "123",
  "messageId": "456",
  "content": "Fixed typo"
}
json
{
  "action": "deleteMessage",
  "channelId": "123",
  "messageId": "456"
}
Threads
json
{
  "action": "threadCreate",
  "channelId": "123",
  "name": "Bug triage",
  "messageId": "456"
}
json
{
  "action": "threadList",
  "guildId": "999"
}
json
{
  "action": "threadReply",
  "channelId": "777",
  "content": "Replying in thread"
}
Pins
json
{
  "action": "pinMessage",
  "channelId": "123",
  "messageId": "456"
}
json
{
  "action": "listPins",
  "channelId": "123"
}
Search messages
json
{
  "action": "searchMessages",
  "guildId": "999",
  "content": "release notes",
  "channelIds": ["123", "456"],
  "limit": 10
}
Member + role info
json
{
  "action": "memberInfo",
  "guildId": "999",
  "userId": "111"
}
json
{
  "action": "roleInfo",
  "guildId": "999"
}
List available custom emojis
json
{
  "action": "emojiList",
  "guildId": "999"
}
Role changes (disabled by default)
json
{
  "action": "roleAdd",
  "guildId": "999",
  "userId": "111",
  "roleId": "222"
}
Channel info
json
{
  "action": "channelInfo",
  "channelId": "123"
}
json
{
  "action": "channelList",
  "guildId": "999"
}
Voice status
json
{
  "action": "voiceStatus",
  "guildId": "999",
  "userId": "111"
}
Scheduled events
json
{
  "action": "eventList",
  "guildId": "999"
}
Moderation (disabled by default)
json
{
  "action": "timeout",
  "guildId": "999",
  "userId": "111",
  "durationMinutes": 10
}

Discord Writing Style Guide

Keep it conversational! Discord is a chat platform, not documentation.

Do
  • Short, punchy messages (1-3 sentences ideal)
  • Multiple quick replies > one wall of text
  • Use emoji for tone/emphasis 🦞
  • Lowercase casual style is fine
  • Break up info into digestible chunks
  • Match the energy of the conversation
Don't
  • No markdown tables (Discord renders them as ugly raw | text |)
  • No ## Headers for casual chat (use bold or CAPS for emphasis)
  • Avoid multi-paragraph essays
  • Don't over-explain simple things
  • Skip the "I'd be happy to help!" fluff
Formatting that works
  • bold for emphasis
  • code for technical terms
  • Lists for multiple items
  • quotes for referencing

  • Wrap multiple links in <> to suppress embeds
Example transformations

❌ 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?

© CraftOS-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in skills/discord of CraftOS-dev/CraftBot.

  • SKILL.md
  • .clawhub/origin.json
  • _meta.json

Open the folder on GitHubat commit b50970c

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in CraftOS-dev/CraftBot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Discord next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Discord compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Discord this skillCraftOS-dev/CraftBot3922 repos~1.8kAutomated safety check: PassMIT
Int Evolution Goevolution-foundation/evo-nexus544—~1.5kAutomated safety check: PassCustom licence
Cover Skillkangarooking/kangarooking-skills656—~2.9kAutomated safety check: PassNone
Ig StoryJakeschincariol/instagram-agent-skill458—~1.1kAutomated safety check: PassMIT
OneWorks 3D Avatar Designeroneworks-ai/avatar250—~1.7kAutomated safety check: PassMIT
AI Model WebTencentCloudBase/CloudBase-AI-Toolkit1.1k2 repos~6.1kAutomated safety check: NotesMIT

Similar skills

  • Int Evolution Go

    evolution-foundation/evo-nexus

    Manage Evolution Go instances and send WhatsApp messages via the Evolution Go REST API.

    544 GitHub stars~1.5k tokensUpdated 4 mo ago
    Backend & APIsAuto-check passed
  • Cover Skill

    kangarooking/kangarooking-skills

    A skill your agent uses for the owner's personal creator-content thumbnails and covers for short video, Bilibili, Douyin, WeChat, or similar platforms from a title, summary, established real…

    656 GitHub stars~2.9k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Ig Story

    Jakeschincariol/instagram-agent-skill

    Write the day's Instagram Stories - the frame-by-frame sequence, which stickers to use where, and the one that moves people into the DMs.

    458 GitHub stars~1.1k tokensUpdated 24 days ago
    Media & CreativeAuto-check passed
  • OneWorks 3D Avatar Designer

    oneworks-ai/avatar

    Creates, refines and exports editable OneWorks 3D geometric avatars for mascots, bots or agents, keeping one shared scene state across preview, share link and export.

    250 GitHub stars~1.7k tokensUpdated 29 days ago
    Media & CreativeAuto-check passed
  • AI Model Web

    TencentCloudBase/CloudBase-AI-Toolkit

    A skill your agent uses when a browser/Web app (React, Vue, Next, Nuxt, static sites, SPAs, dashboards, AI chat UI, 页面, 前端, 网页) needs AI models via @cloudbase/js-sdk.

    1.1k GitHub starsUsed in 2 repos~6.1k tokens
    Media & CreativeAuto-check: notes
  • Og Image Size

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing Open Graph tags or generating og:image assets.

    74k GitHub stars~573 tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from CraftOS-dev/CraftBot

All 89 skills in this repo
  • Self Improvement

    CraftOS-dev/CraftBot

    Captures learnings, errors, and corrections to enable continuous improvement.

    392 GitHub starsUsed in 5 repos~4.9k tokens
    Auto-check passed
  • Bbc News

    CraftOS-dev/CraftBot

    Fetch and display BBC News stories from various sections and regions via RSS feeds.

    392 GitHub starsUsed in 2 repos~555 tokens
    Auto-check passed
  • Outlook

    CraftOS-dev/CraftBot

    Read, search, and manage Outlook emails and calendar via Microsoft Graph API.

    392 GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • Nano Banana Pro

    CraftOS-dev/CraftBot

    Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image).

    392 GitHub starsUsed in 6 repos~1.4k tokens
    Auto-check passed
  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Telegram Bot Manager

    CraftOS-dev/CraftBot

    Manage and configure Telegram bots for OpenClaw. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~836 tokensUpdated today
    Auto-check passed

Works with

Questions about Discord

What does Discord do?

A skill your agent uses 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…. Discord is an agent skill from CraftOS-dev/CraftBot. 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.

When should I use Discord?

Discord fits situations like: you need to control Discord from Clawdbot via the discord tool: send messages; upload stickers; manage threads/pins/search; fetch permissions.

How do I install Discord in Claude Code?

Run `npx skills add CraftOS-dev/CraftBot --skill discord -a claude-code`. Or copy the skill folder (skills/discord in CraftOS-dev/CraftBot) into .claude/skills/discord in your project. Claude Code loads it when a task matches its description.

How do I install Discord in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill discord -a codex`. Or copy the skill folder (skills/discord in CraftOS-dev/CraftBot) into .agents/skills/discord in your project. Codex loads it when a task matches its description.

Can I use Discord in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CraftOS-dev/CraftBot --skill discord -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/discord, .gemini/skills/discord, .github/skills/discord and .opencode/skills/discord in your project.

What does Discord need to run?

SKILL.md names no scripts, command-line tools or credentials: Discord is instructions for the agent only.

Does Discord access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Discord safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Discord use?

Discord is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Discord use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Discord?

Skills that share tags, products or a category with Discord: Int Evolution Go (evolution-foundation/evo-nexus, 544 stars), Cover Skill (kangarooking/kangarooking-skills, 656 stars), Ig Story (Jakeschincariol/instagram-agent-skill, 458 stars) and OneWorks 3D Avatar Designer (oneworks-ai/avatar, 250 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Discord?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

Source: CraftOS-dev/CraftBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.