svenflow/discord

Discord Skill

Send and receive messages in Discord channels via a bot integration.

Usage

Send a message

~/.claude/skills/discord/scripts/send-discord <channel_id> "message"

Reply from a Discord transcript directory

# From ~/transcripts/discord/{channel_id}/
~/.claude/skills/sms-assistant/scripts/reply "message"

Read recent messages (for context)

~/.claude/skills/discord/scripts/read-discord <channel_id>              # Last 25 messages
~/.claude/skills/discord/scripts/read-discord <channel_id> --limit 50   # Last 50 messages
~/.claude/skills/discord/scripts/read-discord <channel_id> --before <message_id>  # Before a message
~/.claude/skills/discord/scripts/read-discord <channel_id> --after <message_id>   # After a message
~/.claude/skills/discord/scripts/read-discord <channel_id> --json       # Raw JSON output

Use this to get context when you are tagged — read the last N messages to understand what the conversation is about before responding.

React to a message with an emoji

~/.claude/skills/discord/scripts/discord-react <channel_id> <message_id> "🦀"

To get message IDs, fetch recent messages via the Discord API:

httpx.get(f"https://discord.com/api/v10/channels/{channel_id}/messages?limit=10",
          headers={"Authorization": f"Bot {token}"})

Use reactions to add personality — react to funny messages, acknowledge things without a full reply, etc.

How It Works

• Bot connects to Discord Gateway via discord.py (runs in a daemon thread)
• Incoming messages are normalized and routed through the bus pipeline (same as iMessage/Signal)
• Outgoing messages use the Discord REST API (httpx POST, no Gateway needed)
• Each channel gets its own SDK session at ~/transcripts/discord/{channel_id}/
• Messages are auto-chunked at 2000 characters (Discord's limit)

Configuration

Discord config lives in ~/dispatch/config.local.yaml:

discord:
  channel_ids:
    - "1234567890"
  bot_role_ids:           # Role IDs that trigger the bot when @mentioned
    - "BOT_ROLE_ID"
  bot_names:              # Name strings that trigger the bot (case-insensitive)
    - "sven"
  users:
    "DISCORD_USER_ID":
      name: "Name"
      tier: "admin"

Mention Filtering

The listener only queues messages that are directed at the bot:

1. @mention of the bot user
2. Role mention matching bot_role_ids
3. Bot name in message text (case-insensitive, from bot_names)
4. Reply to a bot message

All other messages are silently dropped at the listener level (zero token cost).

Bot token stored in macOS Keychain as discord_bot_token.

Token

Stored in keychain:

# Store
security add-generic-password -s discord_bot_token -a sven -w "TOKEN"

# Read
security find-generic-password -s discord_bot_token -w

Response Behavior

Default: respond only when tagged (@bot). Do not reply to every message in a channel.

Exception — active turn-based games: If context from recent messages makes it clearly your turn (e.g., a game prompt directed at you, the previous player completed their turn), respond without requiring a tag. Read game state from the last several messages to determine if it is your turn before acting.

Bot Commands

Discord sessions recognize dot-commands (e.g., .imdb, .help) as special bot commands.

.imdb <title>

Looks up movie or TV show information using the imdb-lookup skill CLI.

~/.claude/skills/imdb-lookup/scripts/imdb-lookup "<title>" --format discord

• Uses --format discord for markdown-formatted output suitable for Discord channels
• Card output includes: title, year, rating, runtime, genres, and IMDb link
• Powered by the TMDB API via the imdb-lookup CLI (no web scraping)