discord-init

lycfyi's avatarfrom lycfyi

Initialize Discord configuration. Use when user wants to set up, configure, or connect their Discord account for the first time.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 9, 2026⬇️2downloads

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.
namediscord-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.yaml doesn'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):

  1. Connects to Discord using your token from ./.env
  2. Lists all servers you have access to
  3. If one server: auto-selects it
  4. If multiple: selects the first one (or use --server to pick)
  5. Saves configuration to ./config/agents.yaml

Output

Updates ./config/agents.yaml with Discord settings:

  • discord.default_server_id: Your Discord server ID
  • discord.default_server_name: Server display name
  • data_dir: Where messages are stored (shared setting)
  • discord.retention_days: Default sync history

Prerequisites

Next Steps

After init, use discord-sync to download messages.