configure-discord_skill

Overview

This skill configures Discord notifications for OMC using natural language prompts. It guides you to set up either a Discord webhook or a bot API integration, choose who to mention, select which events trigger notifications, and saves the settings to ~/.claude/.omc-config.json. It can also write recommended environment variables instead of the config file.

How this skill works

The skill interactively asks targeted questions and validates inputs (webhook URL format, token and channel ID formats, mention IDs). It merges new settings into the existing ~/.claude/.omc-config.json or creates one if absent, and can send a test notification to verify the integration. You can alternatively set environment variables and skip the wizard.

When to use it

• Enable immediate Discord alerts for session lifecycle events
• Get pings when a session needs your input or finishes background tasks
• Integrate a team channel for multi-agent orchestration updates
• Quickly reconfigure or switch between webhook and bot methods
• Verify notification setup with a test message

Best practices

• Prefer Webhook for simple one-off channel posts; no bot required
• Use Bot API for advanced needs (permissions, richer interactions) and supply bot token + channel ID
• Validate IDs using Discord Developer Mode (right-click > Copy ID) for mentions and channels
• Limit mentions to specific user or role IDs to avoid unwanted pings
• Test the configuration immediately and check HTTP response codes if the test fails

Example use cases

• Notify a team channel when a Claude session ends so reviewers can pick up results
• Alert a developer when Claude requests input during a long-running orchestration
• Post status updates to a project Discord when background tasks complete
• Switch from webhook to bot API to gain finer permission control and richer messaging
• Set environment variables in CI to enable notifications without touching the user config file