Discord Server Admin

Manage Discord servers with a narrow, medium-risk scope using direct Bot API calls. Use when creating, renaming, moving, or deleting channels/categories; cre...

Security Scan

The skill's code and instructions match its stated, narrow Discord administration purpose and only require a bot token; nothing in the files suggests hidden endpoints or unrelated permissions.

Purpose & Capability

Name/description, SKILL.md, and the shipped script all align: the tool lists/edits channels and roles and assigns/removes roles via Discord Bot API. No unrelated services, credentials, or binaries are requested.

Instruction Scope

SKILL.md and the script limit actions to channels, roles, and member role assignment and explicitly exclude bans/kicks/webhooks/bulk actions. The runtime instructions only reference Discord API endpoints and local tools (curl, python3).

Install Mechanism

No install spec; the skill is instruction-only with a single helper script. Nothing is downloaded from external URLs or written to system locations by an installer.

Credentials

The only secret required is a Discord bot token (DISCORD_BOT_TOKEN or --token). That is appropriate and proportional for a bot that performs writes to a guild via Discord's API.

Persistence & Privilege

always is false and the skill does not attempt to modify other skills or system-wide configs. It can be invoked autonomously by the agent (platform default), which is expected for skills.

Assessment

This tool is coherent with its description, but it can perform destructive actions (delete channels/roles). Only provide a bot token with the minimum permissions needed (avoid Administrator), use a dedicated bot account, and audit or rotate the token if you stop using the skill. Review and run the script in a safe environment (or a test server) first to confirm behavior. If you want to allow autonomous agent actions, ensure the agent is configured to ask for confirmation before performing writes to production servers.

Use this skill for focused Discord server administration with explicit IDs and limited write scope.

Scope

Supported operations:

• List channels and roles
• Create, edit, and delete channels/categories
• Create, edit, delete, and reorder roles
• Assign and remove roles for members

Out of scope:

• Bans, kicks, timeouts, or other moderation actions
• Webhooks, invites, automod, templates, events, or guild settings
• Bulk/mass operations
• Fuzzy matching by names when exact IDs are available

Quick start

Use scripts/discord-server-admin.sh.

Examples:

export DISCORD_BOT_TOKEN="..."

# Inspect current layout
./scripts/discord-server-admin.sh channel-list <guild_id>
./scripts/discord-server-admin.sh role-list <guild_id>

# Create a category and a text channel under it
./scripts/discord-server-admin.sh channel-create <guild_id> "CLAN HQ" --type category
./scripts/discord-server-admin.sh channel-create <guild_id> clan-chat --type text --parent-id <category_id> --topic "Main clan chat"

# Create or update a role
./scripts/discord-server-admin.sh role-create <guild_id> Member --color 3498DB --permissions 0 --mentionable false --hoist false
./scripts/discord-server-admin.sh role-edit <guild_id> <role_id> --color 2ECC71

# Assign/remove a role
./scripts/discord-server-admin.sh member-role-add <guild_id> <role_id> <user_id>
./scripts/discord-server-admin.sh member-role-remove <guild_id> <role_id> <user_id>

Workflow

1. Start with channel-list or role-list.
2. Confirm exact guild/channel/role/user IDs before writes.
3. Apply one targeted change at a time.
4. If Discord returns 403, check bot permissions and role hierarchy.
5. If a role sits above the bot role, reorder roles in Discord before retrying assignments or edits.

Safety rules

• Treat this as a medium-risk skill because it uses a bot token and can modify server structure.
• Keep the bot token in DISCORD_BOT_TOKEN; do not hardcode secrets into files.
• Prefer least privilege over Administrator when practical.
• Avoid destructive actions unless the user clearly asked for them.
• Do not add mass-delete or bulk moderation features to this skill.
• Use exact IDs for write actions to avoid touching the wrong server object.

Limitations

• Discord role hierarchy still applies even when the bot has strong permissions.
• role-position only moves the role you specify; it is not a full reorder planner.
• channel-create supports text, voice, and category only.
• Permissions must be provided as Discord integer bitfields, not named permission strings.

Resource

• scripts/discord-server-admin.sh — direct HTTPS helper for channels, roles, and member role assignment.