discord-send_skill

Overview

This skill sends messages to Discord channels using a configured user token. It supports posting new messages, replying to specific messages, and returns message metadata on success. Before use, load and apply your configured persona so outgoing messages match voice, style, and signing conventions.

How this skill works

The tool invokes a Python script that posts to Discord via the user token stored in ./.env. You specify a target channel ID and message text; optionally include a reply-to message ID to make a threaded reply. On success it returns the new message ID, channel ID, timestamp, and reply target if used.

When to use it

• You want to post a drafted message to a Discord channel.
• You need to reply to a specific Discord message programmatically.
• You want to post as a configured persona with a consistent tone and signature.
• You have a channel ID and valid user token available.
• You need the message metadata (ID/timestamp) returned after posting.

Best practices

• Always load and apply your configured persona before sending messages so voice and signing are consistent.
• Keep messages under 2000 characters to avoid rejections.
• Confirm channel and message IDs using the discord-list tool or Discord Developer Mode.
• Handle rate limits by respecting automatic backoff and avoid rapid repeated posts.
• Store and protect the user token securely in ./.env and follow platform policies.

Example use cases

• Post an announcement to a community channel using the persona’s voice and signature.
• Reply to a user thread with a clarifying answer and capture the reply message ID for logs.
• Automate routine status updates to a channel and record timestamps for audit.
• Send a prepared message on behalf of a persona during moderated discussions.