Add help menu descriptions to all commands

cogs/afk.py

@@ -147,6 +147,7 @@ def format_afk_duration(self, set_time_str: str) -> str:
 
     @commands.hybrid_command(
         name="afk",
+        description="Set yourself as AFK with an optional reason",
         help="Set yourself as AFK with an optional reason",
         usage="afk [reason]"
     )
@@ -229,6 +230,7 @@ async def remove_afk_command(self, ctx: commands.Context):
 
     @commands.hybrid_command(
         name="afklist",
+        description="List all currently AFK users in the server",
         help="List all currently AFK users in the server",
         aliases=["afkstatus", "whoafk"]
     )

cogs/bump_leaderboard.py

@@ -691,7 +691,7 @@ async def removebumps(self, ctx: commands.Context, user: discord.Member, amount:
     # Prefix-only commands (requested aliases)
     # ----------------------------
 
-    @commands.command(name="mybumps")
+    @commands.command(name="mybumps", help="Show your personal bump stats")
     async def mybumps(self, ctx: commands.Context):
         """Prefix-only: show your bump stats."""
         if ctx.guild is None:
@@ -705,17 +705,17 @@ async def mybumps(self, ctx: commands.Context):
         embed.add_field(name="Last bump", value=self._format_full_time(entry.last_bump_time), inline=False)
         await ctx.send(embed=embed)
 
-    @commands.command(name="blb")
+    @commands.command(name="blb", help="Show the bump leaderboard (alias for bumplb)")
     async def blb(self, ctx: commands.Context):
         """Prefix-only alias for bump leaderboard."""
         await self.bumplb(ctx)  # reuse hybrid handler
 
-    @commands.command(name="bst")
+    @commands.command(name="bst", help="Show total bumps and the most recent bumper (alias for bumpstats)")
     async def bst(self, ctx: commands.Context):
         """Prefix-only alias for bump stats."""
         await self.bumpstats(ctx)
 
-    @commands.command(name="topbump")
+    @commands.command(name="topbump", help="Show the top 3 bumpers in the server")
     async def topbump(self, ctx: commands.Context):
         """Prefix-only: show top 3 bumpers."""
         if ctx.guild is None:

cogs/codebuddy_help.py

@@ -95,7 +95,7 @@ async def help_command(self, interaction: discord.Interaction):
         # Edit the original response with the help embed
         await interaction.edit_original_response(content=None, embed=embed, view=view)
 
-    @commands.command(name="quizhelp")
+    @commands.command(name="quizhelp", help="Get help and information about CodeBuddy bot commands")
     async def quizhelp_prefix(self, ctx):
         """Displays help information about all available commands."""
 

cogs/codebuddy_leaderboard.py

@@ -122,7 +122,7 @@ async def codeweek(self, interaction: discord.Interaction):
             except Exception:
                 pass
 
-    @commands.command(name="codeweek", aliases=["cw", "cwlb"])
+    @commands.command(name="codeweek", aliases=["cw", "cwlb"], help="Show the weekly coding leaderboard")
     async def codeweek_prefix(self, ctx):
         """Display the weekly leaderboard."""
         try:
@@ -301,7 +301,7 @@ async def codestreak(self, interaction: discord.Interaction):
             except Exception:
                 pass
 
-    @commands.command(name="codestreak", aliases=["cs", "cslb"])
+    @commands.command(name="codestreak", aliases=["cs", "cslb"], help="Show the coding streak leaderboard")
     async def codestreak_prefix(self, ctx):
         """Display the streak leaderboard."""
         try:

cogs/codebuddy_quiz.py

@@ -398,7 +398,7 @@ async def leaderboard(self, interaction: discord.Interaction):
             except Exception:
                 pass
 
-    @commands.command(name="codeleaderboard", aliases=["clb"])
+    @commands.command(name="codeleaderboard", aliases=["clb"], help="Show the top players with the most correct answers")
     async def codeleaderboard_prefix(self, ctx: commands.Context):
         """Show the top players with the most correct answers."""
         try:
@@ -498,7 +498,7 @@ async def codestats(self, interaction: discord.Interaction):
             except Exception:
                 pass
 
-    @commands.command(name="codestats", aliases=["cst"])
+    @commands.command(name="codestats", aliases=["cst"], help="Show your personal coding quiz stats")
     async def codestats_prefix(self, ctx: commands.Context):
         """Show your personal coding quiz stats."""
         try:

cogs/counting.py

@@ -617,7 +617,7 @@ async def fail_count(self, message, current_count, reason):
             await self._clear_highscore_marker_if_any(guild_id, message.channel)
 
 
-    @commands.command(name="donateguild", aliases=["dg"])
+    @commands.command(name="donateguild", aliases=["dg"], help="Donate 1 personal save to the guild pool")
     async def donate_guild(self, ctx: commands.Context):
         """Donate 1 personal save to the guild pool (guild receives 0.5 save)."""
         if not ctx.guild:
@@ -649,7 +649,7 @@ async def donate_guild(self, ctx: commands.Context):
         )
 
 
-    @commands.command(name="guildsaves", aliases=["gsaves", "serversaves", "ssaves"])
+    @commands.command(name="guildsaves", aliases=["gsaves", "serversaves", "ssaves"], help="Show the server save pool used to protect counting mistakes")
     async def guild_saves(self, ctx: commands.Context):
         """Show the server save pool used to protect counting mistakes."""
         if not ctx.guild:
@@ -661,7 +661,7 @@ async def guild_saves(self, ctx: commands.Context):
             "(Needs **1.0** server save to protect a ruined count.)"
         )
 
-    @commands.hybrid_command(name="highscoretable", aliases=["highscores"], help="Show recent counting highscores")
+    @commands.hybrid_command(name="highscoretable", aliases=["highscores"], description="Show recent counting highscores", help="Show recent counting highscores")
     async def highscore_table(self, ctx: commands.Context):
         if not ctx.guild:
             return await ctx.send("Server only command.")
@@ -703,7 +703,7 @@ async def highscore_table(self, ctx: commands.Context):
         embed.description = "\n".join(lines)
         await ctx.send(embed=embed)
 
-    @commands.command(name="mcl", aliases=["tc"])
+    @commands.command(name="mcl", aliases=["tc"], help="Leaderboard of users with the most correct counts")
     async def most_count_leaderboard(self, ctx):
         async with aiosqlite.connect(DB_PATH, timeout=30.0) as db:
             async with db.execute("""
@@ -726,7 +726,7 @@ async def most_count_leaderboard(self, ctx):
         embed.description = description
         await ctx.send(embed=embed)
 
-    @commands.command(name="mrl")
+    @commands.command(name="mrl", help="Leaderboard of users who ruined the count the most")
     async def most_ruined_leaderboard(self, ctx):
         async with aiosqlite.connect(DB_PATH, timeout=30.0) as db:
             async with db.execute("""
@@ -749,7 +749,7 @@ async def most_ruined_leaderboard(self, ctx):
         embed.description = description
         await ctx.send(embed=embed)
 
-    @commands.command(name="scs")
+    @commands.command(name="scs", help="Show current count and high score for this server")
     async def server_count_stats(self, ctx):
         async with aiosqlite.connect(DB_PATH, timeout=30.0) as db:
             async with db.execute("SELECT current_count, high_score FROM counting_config WHERE guild_id = ?", (ctx.guild.id,)) as cursor:

cogs/daily_quests.py

@@ -20,7 +20,7 @@ class DailyQuestsCog(commands.Cog):
     def __init__(self, bot: commands.Bot):
         self.bot = bot
 
-    @commands.command(name="dailyquest", aliases=["dq", "quests", "quest", "daily", "checklist"])
+    @commands.command(name="dailyquest", aliases=["dq", "quests", "quest", "daily", "checklist"], help="View your daily quest progress and rewards")
     async def daily_quest(self, ctx: commands.Context):
         """
         View your daily quest progress and rewards.
@@ -80,7 +80,7 @@ async def daily_quest(self, ctx: commands.Context):
             print(f"[Error in daily_quest command]: {e}")
             await ctx.send("An error occurred while fetching your quest progress.", ephemeral=True)
 
-    @commands.command(name="inventory", aliases=["inv", "rewards"])
+    @commands.command(name="inventory", aliases=["inv", "rewards"], help="View your quest rewards inventory")
     async def inventory(self, ctx: commands.Context):
         """View your quest rewards inventory."""
         user_id = ctx.author.id

cogs/fun.py

@@ -178,7 +178,7 @@ async def _get_absolute_template_bytes(self) -> bytes:
             )
             return template_bytes
 
-    @commands.hybrid_command(name="fridge", help="Send a fridge image")
+    @commands.hybrid_command(name="fridge", description="Send a fridge image", help="Send a fridge image")
     @commands.cooldown(1, 15, commands.BucketType.user)
     async def fridge(self, ctx: commands.Context):
         """Send a fridge image (simple utility)."""
@@ -227,7 +227,7 @@ async def fridge(self, ctx: commands.Context):
         await ctx.reply(embed=embed, file=file, mention_author=False)
 
     @commands.hybrid_command(
-        name="compliment", help="Receive a professional programming compliment"
+        name="compliment", description="Receive a professional programming compliment", help="Receive a professional programming compliment"
     )
     async def compliment(
         self, ctx: commands.Context, member: Optional[discord.Member] = None
@@ -246,7 +246,7 @@ async def compliment(
         embed.set_footer(text="CodeVerse Bot | Professional Development")
         await ctx.reply(embed=embed, mention_author=False)
 
-    @commands.hybrid_command(name="joke", help="Get a programming-related joke")
+    @commands.hybrid_command(name="joke", description="Get a programming-related joke", help="Get a programming-related joke")
     async def joke(self, ctx: commands.Context):
         """Share a clean programming joke."""
         joke = random.choice(PROGRAMMING_JOKES)
@@ -260,7 +260,7 @@ async def joke(self, ctx: commands.Context):
         embed.set_footer(text="CodeVerse Bot | Community Fun")
         await ctx.reply(embed=embed, mention_author=False)
 
-    @commands.hybrid_command(name="fortune", help="Get a programming fortune")
+    @commands.hybrid_command(name="fortune", description="Get a programming fortune", help="Get a programming fortune")
     async def fortune(self, ctx: commands.Context):
         """Receive a programming-themed fortune message."""
         fortune = random.choice(FORTUNE_MESSAGES)
@@ -274,7 +274,7 @@ async def fortune(self, ctx: commands.Context):
         embed.set_footer(text="CodeVerse Bot | Daily Inspiration")
         await ctx.reply(embed=embed, mention_author=False)
 
-    @commands.hybrid_command(name="flip", help="Flip a coin")
+    @commands.hybrid_command(name="flip", description="Flip a coin", help="Flip a coin")
     async def flip(self, ctx: commands.Context):
         """Flip a virtual coin."""
         result = random.choice(["Heads", "Tails"])
@@ -314,7 +314,7 @@ async def single_dice(self, ctx: commands.Context, sides: int = 6):
         await ctx.reply(embed=embed, mention_author=False)
 
     @commands.hybrid_command(
-        name="choose", help="Choose randomly from a list of options"
+        name="choose", description="Choose randomly from a list of options", help="Choose randomly from a list of options"
     )
     @app_commands.describe(choices="Comma-separated list of choices")
     async def choose(self, ctx: commands.Context, *, choices: str):
@@ -349,6 +349,7 @@ async def choose(self, ctx: commands.Context, *, choices: str):
         )
         embed.set_footer(text="CodeVerse Bot | Decision Helper")
         await ctx.reply(embed=embed, mention_author=False)
+    @commands.hybrid_command(name="absolute", description="Generate an 'ABSOLUTE cinema' GIF with your text", help="Generate an 'ABSOLUTE cinema' GIF with your text")
     @app_commands.describe(text="Text to replace 'cinema' with")
     async def absolute(self, ctx: commands.Context, *, text: str):
 

cogs/help.py

@@ -491,7 +491,7 @@ class HelpCog(commands.Cog):
     def __init__(self, bot: commands.Bot):
         self.bot = bot
 
-    @commands.command(name="helpmenu", description="Show help for commands or a specific command/cog")
+    @commands.command(name="helpmenu", help="Show help for commands or a specific command/cog")
     async def helpmenu(self, ctx: commands.Context, *, query: Optional[str] = None):
         """Show interactive help menu or detailed help for a specific command/category."""
         await self._show_help(ctx, query)

cogs/misc.py

@@ -708,7 +708,7 @@ async def say(self, interaction: discord.Interaction, text: str):
             ephemeral=True
         )
 
-    @commands.command(name='dm', description='Explains why you should not DM members for help')
+    @commands.command(name='dm', help='Explains why you should not DM members for help')
     async def dm_command(self, ctx: commands.Context):
         """Explains why questions should be asked in the server instead of DMs."""
         message = (

cogs/staff_applications.py

@@ -506,7 +506,7 @@ async def register_persistent_views(self):
         except Exception as e:
             logger.error(f"Failed to load persistent views: {e}")
 
-    @commands.hybrid_command(name="panel", description="Post the staff application panel")
+    @commands.hybrid_command(name="panel", description="Post the staff application panel", help="Post the staff application panel")
     @commands.has_permissions(administrator=True)
     async def panel(self, ctx):
         embed = discord.Embed(

cogs/tags.py

@@ -41,7 +41,7 @@ async def tags_group(self, ctx: commands.Context):
         if ctx.invoked_subcommand is None:
             await ctx.send("Use /tags list or /tag <name>")
 
-    @commands.hybrid_command(name="tag", help="Get a tag by name.")
+    @commands.hybrid_command(name="tag", description="Get a tag by name.", help="Get a tag by name.")
     @app_commands.describe(name="Tag name to fetch")
     @commands.guild_only()
     async def tag(self, ctx: commands.Context, name: str):

cogs/tickets.py

@@ -941,7 +941,7 @@ async def _log_ticket_action(self, action: str, ticket_id: int, thread: discord.
         except Exception as e:
             print(f"[Tickets] Failed to send log: {e}")
 
-    @commands.hybrid_command(name="ticketpanel")
+    @commands.hybrid_command(name="ticketpanel", description="Create a ticket panel with a button to open tickets", help="Create a ticket panel with a button to open tickets")
     @commands.has_permissions(administrator=True)
     @app_commands.describe(
         channel="Channel to send the ticket panel to",
@@ -1067,7 +1067,7 @@ async def ticket_panel(self, ctx,
             ephemeral=True
         )
 
-    @commands.hybrid_command(name="ticketlog")
+    @commands.hybrid_command(name="ticketlog", description="Set up or view the ticket log channel", help="Set up or view the ticket log channel")
     @commands.has_permissions(administrator=True)
     @app_commands.describe(
         channel="The channel to use for ticket logs (leave empty to view current setting)"
@@ -1191,7 +1191,7 @@ async def ticket_log_setup(self, ctx, channel: Optional[discord.TextChannel] = N
                 ephemeral=True
             )
 
-    @commands.hybrid_command(name="ticketlog-disable")
+    @commands.hybrid_command(name="ticketlog-disable", description="Disable ticket logging for this server", help="Disable ticket logging for this server")
     @commands.has_permissions(administrator=True)
     async def ticket_log_disable(self, ctx):
         """Disable ticket logging for this server"""
@@ -1243,7 +1243,7 @@ async def ticket_log_disable(self, ctx):
                 ephemeral=True
             )
 
-    @commands.hybrid_command(name="ticketsupport")
+    @commands.hybrid_command(name="ticketsupport", description="Set up or view the support role for ticket notifications", help="Set up or view the support role for ticket notifications")
     @commands.has_permissions(administrator=True)
     @app_commands.describe(
         role="The role to ping when new tickets are created (leave empty to view current setting)"
@@ -1332,7 +1332,7 @@ async def ticket_support_role(self, ctx, role: Optional[discord.Role] = None):
                 ephemeral=True
             )
 
-    @commands.hybrid_command(name="ticketsupport-disable")
+    @commands.hybrid_command(name="ticketsupport-disable", description="Disable the custom support role for tickets", help="Disable the custom support role for tickets")
     @commands.has_permissions(administrator=True)
     async def ticket_support_role_disable(self, ctx):
         """Disable the custom support role for tickets"""
@@ -1384,7 +1384,7 @@ async def ticket_support_role_disable(self, ctx):
                 ephemeral=True
             )
 
-    @commands.hybrid_command(name="tickets")
+    @commands.hybrid_command(name="tickets", description="View all tickets, filterable by status or user", help="View all tickets, filterable by status or user")
     @commands.has_permissions(manage_messages=True)
     @app_commands.describe(
         status="Filter tickets by status (open, closed, all)",
@@ -1462,7 +1462,7 @@ async def tickets_list(self, ctx, status: str = "open", user: Optional[discord.U
 
         await ctx.send(embed=embed)
 
-    @commands.hybrid_command(name="ticketstats")
+    @commands.hybrid_command(name="ticketstats", description="View ticket statistics for this server", help="View ticket statistics for this server")
     @commands.has_permissions(manage_messages=True)
     async def ticket_stats(self, ctx):
         """View ticket statistics"""
@@ -1512,7 +1512,7 @@ async def ticket_stats(self, ctx):
 
         await ctx.send(embed=embed)
 
-    @commands.hybrid_command(name="forceclose")
+    @commands.hybrid_command(name="forceclose", description="Force close a ticket by its ID (Staff only)", help="Force close a ticket by its ID (Staff only)")
     @commands.has_permissions(manage_messages=True)
     @app_commands.describe(
         ticket_id="The ID of the ticket to force close",
@@ -1646,7 +1646,7 @@ async def force_close_ticket(self, ctx, ticket_id: int, *, reason: str = "Force
 
         print(f"[Tickets] 🔒 Ticket #{ticket_id} force closed by {ctx.author} - Reason: {reason}")
 
-    @commands.hybrid_command(name="ticketreport")
+    @commands.hybrid_command(name="ticketreport", description="Set up or view the report role for report ticket notifications", help="Set up or view the report role for report ticket notifications")
     @commands.has_permissions(administrator=True)
     @app_commands.describe(
         role="The role to ping when report tickets are created (leave empty to view current setting)"
@@ -1738,7 +1738,7 @@ async def ticket_report_role(self, ctx, role: Optional[discord.Role] = None):
                 ephemeral=True
             )
 
-    @commands.hybrid_command(name="ticketreport-disable")
+    @commands.hybrid_command(name="ticketreport-disable", description="Disable the custom report role for tickets", help="Disable the custom report role for tickets")
     @commands.has_permissions(administrator=True)
     async def ticket_report_role_disable(self, ctx):
         """Disable the custom report role for tickets"""
@@ -1785,7 +1785,7 @@ async def ticket_report_role_disable(self, ctx):
                 ephemeral=True
             )
 
-    @commands.hybrid_command(name="ticketpartner")
+    @commands.hybrid_command(name="ticketpartner", description="Set up or view the partner role for partnership ticket notifications", help="Set up or view the partner role for partnership ticket notifications")
     @commands.has_permissions(administrator=True)
     @app_commands.describe(
         role="The role to ping when partnership tickets are created (leave empty to view current setting)"
@@ -1877,7 +1877,7 @@ async def ticket_partner_role(self, ctx, role: Optional[discord.Role] = None):
                 ephemeral=True
             )
 
-    @commands.hybrid_command(name="ticketpartner-disable")
+    @commands.hybrid_command(name="ticketpartner-disable", description="Disable the custom partner role for tickets", help="Disable the custom partner role for tickets")
     @commands.has_permissions(administrator=True)
     async def ticket_partner_role_disable(self, ctx):
         """Disable the custom partner role for tickets"""