Discord Chat

Send messages, reply to messages, and search message history in Discord channels using the message tool. Use when the user wants to communicate with Discord (send/reply/search messages), check Discord activity, or interact with Discord channels.

Security Scan

The skill's instructions, required resources, and scope are coherent with a Discord messaging integration and do not request unrelated credentials or perform unexpected actions.

Purpose & Capability

Name/description (Discord messaging/search) match the SKILL.md and reference docs. All actions (send, reply, search, channel management) are appropriate for a Discord bot integration.

Instruction Scope

Runtime instructions are limited to calling a local 'message' tool with Discord-specific parameters and referencing gateway config. There are no instructions to read unrelated system files, harvest environment variables beyond the expected bot token, or exfiltrate data to unexpected endpoints.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is written to disk or downloaded by the skill itself. This is lowest-risk for install mechanics.

Credentials

The skill itself declares no required env vars or credentials. The documentation appropriately advises storing a Discord bot token in the gateway config or environment variables; that is expected for a Discord integration and proportional to the described functionality.

Persistence & Privilege

always is false and the skill doesn't request any platform-wide privileges or attempt to modify other skills' configs. Autonomous invocation (model invocation) is allowed but is the platform default and not excessive here.

Assessment

This skill is an instruction-only guide for routing actions through your gateway's 'message' tool and is coherent with a Discord bot integration. Before installing, verify you trust the skill owner and — crucially — the underlying gateway/plugin that actually holds and uses your bot token. Ensure you store the Discord bot token (DISCORD_BOT_TOKEN) securely (environment or secrets manager), grant the bot only the minimal permissions it needs, enable webhook secrets if you expose inbound webhooks, and monitor/rotate the token if it may be exposed. Because the skill is just documentation, the main risk is from the gateway or message plugin it expects to call; confirm those components are from trusted sources and audited. If you plan to allow autonomous agent actions, also audit what actions the agent is permitted to run (e.g., deleting channels/messages).

Interact with Discord channels using Clawdbot's message tool.

Core Actions

Send Messages

Send a message to a Discord channel:

message action=send channel=discord target="#channel-name" message="Your message here"

Or by channel ID:

message action=send channel=discord target="1234567890" message="Your message here"

Tips:

• Use channel names with # prefix or channel IDs
• For multiple links, wrap in <> to suppress embeds: <https://example.com>
• No markdown tables! Use bullet lists instead
• Support effects with effect=balloons or effectId=invisible-ink

Reply to Messages

Reply to a specific message:

message action=send channel=discord target="#channel-name" message="Reply text" replyTo="message-id"

The replyTo parameter creates a threaded reply to the specified message ID.

Search Messages

Search for messages in a channel:

message action=search channel=discord channelId="1234567890" query="search terms" limit=50

Search options:

• query: Search terms
• authorId: Filter by author
• before/after/around: Message ID for pagination
• limit: Max results (default 25)

See SEARCH.md for advanced search patterns.

Other Actions

Read messages:

message action=read channel=discord target="#channel-name" limit=20

React to messages:

message action=react channel=discord messageId="1234567890" emoji="👍"

Edit messages:

message action=edit channel=discord messageId="1234567890" message="Updated text"

Delete messages:

message action=delete channel=discord messageId="1234567890"

Quick Reference

Common patterns:

• Announce to channel: action=send target="#announcements"
• Reply in thread: action=send replyTo="msg-id"
• Recent activity: action=read limit=10
• Find mentions: action=search query="@username"
• Acknowledge: action=react emoji="✅"

Channel Management

List channels:

message action=channel-list channel=discord guildId="server-id"

Get channel info:

message action=channel-info channel=discord channelId="1234567890"

For creating/editing channels, see CHANNELS.md.

Best Practices

1. Use target names when possible - target="#general" is clearer than IDs
2. Batch reactions - One emoji per message, pick the best fit
3. Format for Discord - Bullets not tables, <link> to suppress embeds
4. Search before asking - Check history before requesting info
5. React > Reply - Use reactions for simple acknowledgments

Configuration

Your Discord bot configuration should be in the gateway config. The message tool routes to the configured Discord plugin automatically when channel=discord is specified.

For setup help, see CONFIG.md.