Discord Chat 1.0.0

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

Security Scan

This is an instruction-only Discord messaging skill whose requirements and instructions match its stated purpose and do not ask for unexpected credentials or installs.

Purpose & Capability

The name/description (send/reply/search Discord messages) aligns with the SKILL.md and reference docs. The skill is instruction-only and does not request unrelated binaries, environment variables, or config paths.

Instruction Scope

Runtime instructions are limited to invoking the 'message' tool (send/search/read/react/edit/delete, channel management). The docs also show how to update gateway configuration (gateway action=config.patch) and restart the gateway; that is within the expected scope for a channel integration but means an agent with access to the gateway tool could change bot tokens or config if granted those permissions.

Install Mechanism

No install spec and no code files — instruction-only. Nothing is downloaded or written to disk by the skill itself.

Credentials

The skill does not declare required env vars or credentials, but the docs explicitly instruct storing the Discord bot token in the gateway config or environment (e.g., DISCORD_BOT_TOKEN). This is appropriate for the purpose, but sensitive: anyone or any tool with permission to patch the gateway config can inject/replace tokens.

Persistence & Privilege

always is false and there is no install or persistent agent presence requested. The skill does show how to modify gateway config (which could be sensitive) but the skill itself does not request elevated or permanent privileges.

Assessment

This skill is coherent and appears to do what it says: it provides command examples for a 'message' tool to interact with Discord and documents where to store a bot token. It does not itself request credentials or install code. Before enabling it, check how your agent is permitted to act: if the agent can run gateway config changes (gateway action=config.patch) or access process environment variables, it could read or replace your Discord token. Only grant the agent the minimal permissions it needs (send/search messages), store tokens in a secrets store or environment not directly writable by untrusted agents, and rotate tokens if you suspect exposure. If you are unsure about allowing automated config changes, avoid granting the agent the gateway/config patching capability.

Discord Chat

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.