DiscordAdmin

Discord server administration skill for managing the Cyber Defense Tactics community Discord server.

Workflow Routing

Configuration

Environment Variables (in ~/.claude/.env)

# Discord Bot (Cyber Defense Tactics)
DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_GUILD_ID=1462915757401706617

# Role IDs
DISCORD_ROLE_PREMIUM=1463398729972449352
DISCORD_ROLE_MENTORSHIP=1463399070298275873
DISCORD_ROLE_ENTERPRISE=1463399178506993685

Server Structure

Guild ID: 1462915757401706617

Channels (Public):

• #welcome
• #introductions
• #general-discussion
• #free-resources
• #job-postings
• #wins-and-celebrations

Channels (Premium - role-gated):

• #premium-lounge
• #detection-engineering
• #ai-tools-and-tips
• #career-strategy
• #course-discussion

Channels (Mentorship - role-gated):

• #mentorship-cohort
• #mentor-office-hours (voice)

Role Hierarchy

Capabilities

Currently Implemented

• Role Sync - Add/remove roles based on subscription tier
• Member Lookup - Check if user is server member and their roles

Implemented Capabilities

• Role Sync - Add/remove roles based on subscription tier
• Member Lookup - Check if user is server member and their roles
• Moderation - Timeout, kick, ban with audit logging
• Announcements - Post messages and embeds to channels
• Analytics - Server stats, member counts, role distribution

Planned Capabilities

• Welcome - Auto-greet new members, send onboarding DM
• AI Moderation - Auto-detect spam, toxicity, scam links
• Real-time Gateway - WebSocket connection for live events

API Reference

Discord API v10

Base URL: https://discord.com/api/v10

Common Endpoints

// Get guild member
GET /guilds/{guild_id}/members/{user_id}

// Add role to member
PUT /guilds/{guild_id}/members/{user_id}/roles/{role_id}

// Remove role from member
DELETE /guilds/{guild_id}/members/{user_id}/roles/{role_id}

// Get guild channels
GET /guilds/{guild_id}/channels

// Send message to channel
POST /channels/{channel_id}/messages

// Get guild info
GET /guilds/{guild_id}

Authentication

All requests require Authorization: Bot {BOT_TOKEN} header.

Examples

Example 1: Post an announcement

User: "Post an announcement in the general channel about the new course launch"
→ Invokes Announce workflow
→ Formats message with branding
→ Posts to #general-discussion
→ Confirms with message link

Example 2: Check server stats

User: "How many members do we have in Discord?"
→ Invokes ServerStats workflow
→ Fetches guild info via API
→ Returns member count, online count, role distribution

Example 3: Sync a user's role

User: "Add premium role to Discord user 123456789"
→ Invokes ManageRoles workflow
→ Calls Discord API to add role
→ Confirms success

Existing Integration

The bot is already integrated with the Cyber Defense Tactics website:

• Webhook: /api/webhooks/discord - handles role sync from Stripe subscriptions
• Flow: Stripe webhook → Update DB tier → Sync Discord role

Security Notes

• Bot token is stored in environment variables (never committed)
• Internal API key required for webhook calls
• Role management restricted to subscription-related roles
• Admin commands require verification of user permissions