auto-roles

Automates Discord role assignment via join events, buttons, and select menus.

2|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/adraalabs/skills --skill auto-roles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-roles
Source: https://github.com/adraalabs/skills/tree/main/auto-roles
Command: npx skills add https://github.com/adraalabs/skills --skill auto-roles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically assigns roles to new members and enables users to pick roles via interactive menus, simplifying server onboarding and ongoing role management.

Core Features & Use Cases

  • Auto-role on join: triggers on member_join and assigns a role_id, with optional show_select to ask which role.
  • Reaction roles: send_interactive with an embed listing available roles + buttons; for each button, map to an assign_role action and a confirmation message.
  • Select menu roles: send_interactive with select_menu to allow users to pick multiple roles; selections map to role assignments.
  • Key rules: Ask which roles with show_select(select_type:"role") — native Discord role picker; Button IDs must be unique — include the role ID; {caller} in button/select handlers = the person who clicked; For toggle behavior, use conditional steps.

Quick Start

Enable auto-roles and configure the available roles using join, reaction, or select-menu options.

Frequently Asked Questions about auto-roles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically assign Discord roles to new members when they join?

You can automate Discord role assignment by configuring a member_join trigger to assign a specific role_id immediately when users enter the server, streamlining onboarding.

What is the best way to set up reaction roles using buttons in Discord?

Discord reaction roles are configured using send_interactive to post an embed with buttons, where each unique button ID maps to an assign_role action and a confirmation message, allowing users to self-select roles.

Can I use a select menu to let Discord users pick multiple roles at once?

Yes, you can use send_interactive with a select_menu to present available roles, allowing Discord users to pick multiple roles from the dropdown, with each selection mapping directly to an assign_role action.

Does this Discord role management approach support toggle behavior for adding and removing roles?

Toggle behavior for adding and removing Discord roles is supported by using conditional steps within the button or select menu handlers, enabling users to toggle their assigned roles on and off interactively.

How do I ask new Discord members to choose a role during onboarding?

You can ask new Discord members to choose a role during onboarding by using the show_select(select_type:"role") parameter with the member_join trigger, which displays a native Discord role picker for them to select from.