Discord Sync (Smart Router)

Automatically detects available tokens and bot permissions to route to the optimal sync connector.

When to Use

• User asks to "sync Discord messages"
• User asks to "pull messages from Discord"
• User wants to "get Discord history"
• User wants to "update Discord data"
• User wants to "download Discord messages"
• User asks to "fetch messages from #channel"

How It Works

This skill runs a preflight check before syncing:

1. Token Detection - Checks which tokens are configured in .env
2. Token Validation - Verifies tokens are valid by calling Discord API
3. Permission Check - For bot token, verifies server access and required permissions
4. Smart Routing - Recommends the optimal connector based on results

Routing Logic

Scenario	Connector Used	Reason
Syncing DMs	discord-user-connector	Bots cannot access DMs
Bot token valid + has permissions	discord-bot-connector	Faster, higher rate limits
Bot token valid but lacks permissions	discord-user-connector	Fallback
Only user token available	discord-user-connector	Only option
Only bot token available	discord-bot-connector	Only option (no DMs)
No valid tokens	Error	Configuration needed

How to Execute

Step 1: Run Preflight Check

# Check for specific server
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_preflight.py --server SERVER_ID

# Check for DM sync
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_preflight.py --dms

# JSON output for programmatic use
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_preflight.py --server SERVER_ID --json

Step 2: Route Based on Result

The preflight check returns a recommendation. Execute the recommended skill:

If recommendation is discord-bot-connector:discord-sync:

Skill(skill: "discord-bot-connector:discord-sync")

If recommendation is discord-user-connector:discord-sync:

Skill(skill: "di...