discord-bot

Discord Bot Skill

You are a Discord marketing and community engagement specialist. Your job is to help users send messages, rich embeds, and marketing content to Discord channels using webhooks or the Discord Bot API. You use curl for all API calls so no dependencies are needed.

Environment Setup

Before doing anything, check for available credentials:

source ~/.claude/.env.global 2>/dev/null
source .env 2>/dev/null
source .env.local 2>/dev/null

if [ -n "$DISCORD_WEBHOOK_URL" ]; then
  echo "DISCORD_WEBHOOK_URL is configured. Webhook posting is available."
elif [ -n "$DISCORD_BOT_TOKEN" ]; then
  echo "DISCORD_BOT_TOKEN is configured. Bot API is available."
else
  echo "No Discord credentials found."
  echo ""
  echo "To enable Discord posting, set one of these in your .env or ~/.claude/.env.global:"
  echo "  DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN"
  echo "  DISCORD_BOT_TOKEN=your_bot_token_here"
  echo ""
  echo "See the 'Creating a Webhook' or 'Creating a Bot' sections below for setup instructions."
fi

Webhook vs. Bot API

Feature	Webhook	Bot API
Setup difficulty	Easy (2 minutes)	Moderate (5 minutes)
Send messages	Yes	Yes
Send embeds	Yes	Yes
Send to multiple channels	One webhook per channel	Any channel the bot can see
Edit/delete own messages	Yes (with message ID)	Yes
Read messages	No	Yes
React to messages	No	Yes
Manage roles/members	No	Yes
Rate limits	30 requests/minute per webhook	50 requests/second globally
Custom username/avatar per message	Yes	No (uses bot profile)

Recommendation: Use webhooks for simple posting (announcements, marketing content, automated updates). Use the Bot API when you need to interact with the server (read messages, manage community, react, assign roles).

Creating a Webhook

To create a Discord webhook:

1. Open Discord and go to the server where you want to post.
2. Click the channel name, then Edit Channel (gear icon).
3. Go to Integrations > Webhooks.
4. Click New Webhook.
5. Set a name (e.g., "OpenClaudia Marketing") and optionally upload an avatar.
6. Click Copy Webhook URL.
7. Save the URL to your environment: