By name: discord-client description: "Interact with Discord via a bot: read channels, send messages, list guilds/channels, upload files, manage threads. Uses the Discord REST API with a bot token stored in ~/.zeebot/api_keys/discord.txt." disable-model-invocation: true argument-hint: "[action, e.g. 'read messages in #general' or 'send hello to channel 123']" allowed-tools: Read, Grep, Bash, Glob, Write
Discord Client
Use this skill to interact with Discord via the bot account.
Quick Reference
All commands use the helper script at /Users/z80/dev/lemon/.claude/skills/discord-client/discord_api.py.
Run via uv so no install is needed:
SCRIPT="/Users/z80/dev/lemon/.claude/skills/discord-client/discord_api.py"
uv run --with httpx python "$SCRIPT" <command> [args]
Commands
| Command | Description |
|---|---|
me |
Show bot info |
guilds |
List all servers the bot is in |
channels <guild_id> |
List channels in a server |
read <channel_id> [--limit N] [--before ID] [--after ID] |
Read messages (default 50, oldest first) |
send <channel_id> "message" |
Send a message |
reply <channel_id> <msg_id> "text" |
Reply to a message |
edit <channel_id> <msg_id> "new text" |
Edit a bot message |
delete <channel_id> <msg_id> |
Delete a message |
react <channel_id> <msg_id> <emoji> |
Add a reaction |
upload <channel_id> <file_path> [--caption "text"] |
Upload a file |
threads <channel_id> |
List threads |
thread-create <channel_id> "name" |
Create a thread |
members <guild_id> [--limit N] |
List server members |
Workflow
- Discover: Run
guildsto find the guild ID, thenchannels <guild_id>to find channel IDs. - Read: Run
read <channel_id>to see recent messages. Use--limit,--before,--afterto paginate. - Act: Use
send,reply,edit,delete,react,uploadas needed.
Token
The bot token is loaded automatically from ~/.zeebot/api_keys/discord.txt (field: bot_token).
- NEVER print, echo, or commit the token.
- NEVER include the token in scripts written to disk.
- The helper script reads it at runtime from the secrets file.
Notes
- The bot can only act in servers/channels it has been invited to with appropriate permissions.
- Message content requires the Message Content Intent to be enabled in the Discord Developer Portal.
- The bot can read messages from other bots and users.
- Rate limits: Discord enforces per-route rate limits. The script will get HTTP 429 if you hit them — back off and retry.
- Max message length: 2000 characters. For longer content, split into multiple messages or upload as a file.
Custom Scripts
For operations not covered by the CLI, write a temporary Python script that imports the helpers:
import sys
sys.path.insert(0, "/Users/z80/dev/lemon/.claude/skills/discord-client")
from discord_api import load_token, api_get, api_post, BASE
token = load_token()
# ... custom API calls
If $ARGUMENTS is provided, perform the requested Discord action.