discord-init_skill

Overview

This skill initializes and saves Discord configuration so your agent can access and sync server messages. It connects with your Discord user token, detects available servers, and writes the chosen server settings into a local agents configuration file. Use it as the first setup step before running message sync or analysis tools.

How this skill works

The skill reads your DISCORD_USER_TOKEN from a local .env file and uses it to list servers you can access. It auto-selects a single server or picks the first available server (unless you pass a specific server ID). Finally, it writes the server ID, server name, data directory, and retention settings into ./config/agents.yaml for downstream tools to use.

When to use it

• Setting up Discord access for the first time
• Connecting or re-connecting a Discord account to the agent
• Preparing a server before running message sync or analysis
• When ./config/agents.yaml is missing or needs updating
• Switching the default server for sync operations

Best practices

• Store DISCORD_USER_TOKEN in a secure .env file in your working directory
• Run the init tool from the project root so relative paths like ./config resolve correctly
• Specify --server SERVER_ID to force a particular server when you have access to multiple servers
• Verify ./config/agents.yaml after init to confirm data_dir and retention settings
• Back up existing config before re-running init if you have custom changes

Example use cases

• First-time setup: initialize Discord settings before running discord-sync
• Recovering access: reconfigure if tokens or servers have changed
• CI or automation: script initialization in deployment workflows with --server to select a known server
• Multiple servers: quickly switch the default server ID used by sync and analysis tools
• Preparing data collection: set data_dir and retention to control where and how much message history is stored