| 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
guilds to find the guild ID, then channels <guild_id> to find channel IDs.
- Read: Run
read <channel_id> to see recent messages. Use --limit, --before, --after to paginate.
- Act: Use
send, reply, edit, delete, react, upload as 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()
If $ARGUMENTS is provided, perform the requested Discord action.
