discord-bot-architect — Claude Code skill: Discord.js and Pycord bots
Gives your agent working patterns for Discord bots in JavaScript and Python: slash commands, buttons, menus, sharding. Useful once a bot outgrows a toy example.
npx claude-code-templates@latest --skill enterprise-communication/discord-bot-architectWhat discord-bot-architect does
The skill covers two foundations: Discord.js v14 for JavaScript and Pycord for Python. You get templates for the entry point, loading commands and events from folders, and registering slash commands with SlashCommandBuilder or bot.slash_command. Your agent stops inventing project structure from scratch.
A separate section handles interactive pieces: buttons, select menus, modals, and collecting responses with a timeout. Operations get attention too — gateway intents, rate limiting, sharding. The advice on intents is blunt: MessageContent and members are marked privileged, so enable them only when you actually need them.
One detail trips people up: command sync. In the Pycord sample the bot.sync_commands() call sits commented out with a warning to be careful. Run sync on every startup and guild commands lag behind, which is how you end up with duplicates. The bot token comes from DISCORD_TOKEN via dotenv, so set that environment variable before you start.
What it helps with
- scaffold a Discord.js v14 bot with commands loaded from a folder
- build a Pycord bot and move commands into cogs
- add a slash command with options and an embed reply
- create a menu with buttons and a role select list
- sort out privileged intents and sharding
Example prompts for the agent
- scaffold a Discord bot with Discord.js v14 and a ping slash command
- port this bot to Pycord and split the commands into cogs
- add confirm and cancel buttons to the menu command
How to install discord-bot-architect
1claude-code-templates
npx claude-code-templates@latest --skill enterprise-communication/discord-bot-architect2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill discord-bot-architect -a claude-code3Manually: put the files in place
~/.claude/skills/discord-bot-architect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/discord-bot-architect/
Manually: put the files in place
.agents/skills/discord-bot-architect/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/discord-bot-architect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates discord-bot-architect2Manually: put the files in place
.github/skills/discord-bot-architect/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/enterprise-communication/discord-bot-architectManually: put the files in place
.devin/skills/discord-bot-architect/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about discord-bot-architect
How do I install discord-bot-architect in Claude?
Use the templates CLI: npx claude-code-templates@latest --skill enterprise-communication/discord-bot-architect. Or run npx skills add davila7/claude-code-templates --skill discord-bot-architect -a claude-code. The skill file lands at ~/.claude/skills/discord-bot-architect/SKILL.md.
What does discord-bot-architect do?
It hands your agent patterns for Discord bots on Discord.js and Pycord: entry point, slash commands, buttons, menus, modals, plus intents and sharding.
Does the skill need a bot token?
Yes. The code logs in through process.env.DISCORD_TOKEN in JavaScript and os.environ["DISCORD_TOKEN"] in Python, with the value loaded from .env by dotenv.
