discord-init
Initialize Discord configuration. Use when user wants to set up, configure, or connect their Discord account for the first time.
When & Why to Use This Skill
This Claude skill automates the initialization and configuration of Discord connections for AI agents. It streamlines the setup process by securely connecting to the Discord API, auto-detecting available servers, and generating the necessary local configuration files (agents.yaml) required for subsequent communication and synchronization tasks.
Use Cases
- First-time Setup: Quickly establish a connection between your Claude agent and Discord by automating token validation and server selection.
- Environment Configuration: Automatically generate and update local configuration files to ensure the agent has the correct server IDs and retention settings.
- Server Migration: Easily switch the agent's target Discord server by re-running the initialization with a specific server ID flag.
- Troubleshooting: Use as a diagnostic tool to verify Discord API access and refresh local settings when connection issues arise.
| name | discord-init |
|---|---|
| description | "Initialize Discord configuration. Use when user wants to set up, configure, or connect their Discord account for the first time." |
Discord Init
Automatically configure the Discord server from your account.
When to Use
- User says "set up Discord" or "configure Discord"
- User says "connect my Discord account"
- User says "initialize Discord"
- First time setup before syncing
- When
config/agents.yamldoesn't exist or needs updating
How to Execute
Auto-detect and save server:
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_init.py
Select a specific server:
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_init.py --server SERVER_ID
What It Does
All paths are relative to cwd (current working directory):
- Connects to Discord using your token from
./.env - Lists all servers you have access to
- If one server: auto-selects it
- If multiple: selects the first one (or use
--serverto pick) - Saves configuration to
./config/agents.yaml
Output
Updates ./config/agents.yaml with Discord settings:
discord.default_server_id: Your Discord server IDdiscord.default_server_name: Server display namedata_dir: Where messages are stored (shared setting)discord.retention_days: Default sync history
Prerequisites
./.envfile withDISCORD_USER_TOKENset (in cwd)- Get your token: https://discordhunt.com/articles/how-to-get-discord-user-token
Next Steps
After init, use discord-sync to download messages.