discord-bot_skill

Overview

This skill integrates with the Discord REST API to manage servers, channels, messages, roles, members, and webhooks. It provides a lightweight, dependency-free Python CLI for common bot automation tasks, moderation, and community management. Designed for AI agents and scripting environments, it outputs JSON by default for programmatic use.

How this skill works

The tool issues authenticated REST requests to Discord using a bot token provided via the DISCORD_BOT_TOKEN environment variable. Commands cover guild inspection, channel creation and updates, message operations, role and member management, webhooks, threads, emojis, and audit log retrieval. All responses are printed to stdout as JSON, with an optional human-readable flag for formatted output.

When to use it

• Automate routine moderation tasks (kick, ban, role assignments).
• Send scheduled or event-based messages and embeds across channels.
• Create, update, or audit server channels and settings programmatically.
• Integrate external systems via webhooks to post updates into Discord.
• Collect server or channel data for analytics or backups.

Best practices

• Store the bot token securely and never hard-code it; use DISCORD_BOT_TOKEN env var.
• Run commands with --human for manual inspection and default JSON for automation or pipelines.
• Limit API request volume and respect Discord rate limits; batch operations when possible.
• Test destructive commands (delete, ban) in a private test guild before running on production.
• Use role and permission checks before assigning or modifying roles to avoid privilege escalation.

Example use cases

• Deploy a bot that posts release notes and changelogs to announcement channels via send-embed or webhooks.
• Automate onboarding by assigning roles to new users and posting welcome messages in a dedicated channel.
• Run periodic audits of server settings and channels to produce JSON reports for compliance or backup.
• Moderate chat by listing recent messages, reacting, editing or deleting problematic posts, and applying sanctions.
• Create and manage ephemeral threads for event discussions and archive thread activity into external systems.