# discord-bot-architect

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.

- skill · `type=skill` · Claude Code · 106 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/discord-bot-architect
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/discord-bot-architect

## What it 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.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill enterprise-communication/discord-bot-architect
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill discord-bot-architect -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/discord-bot-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/discord-bot-architect/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/discord-bot-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/discord-bot-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates discord-bot-architect
```

2. **Manually: put the files in place**
- File: `.github/skills/discord-bot-architect/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/enterprise-communication/discord-bot-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/discord-bot-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/discord-bot-architect

## When to use it
- 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
- 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

## Similar
- [discord-bot](https://affpapa.org/en/nevibecode/skills/discord-bot.md) — skill · 5300 installs
- [discord](https://affpapa.org/en/nevibecode/skills/discord.md) — skill · 3000 installs
- [telegram-group-analytics-bot](https://affpapa.org/en/nevibecode/skills/telegram-group-analytics-bot.md) — skill · 610 installs
- [senior-architect](https://affpapa.org/en/nevibecode/skills/senior-architect.md) — skill · 1494 installs
- [chat-sdk](https://affpapa.org/en/nevibecode/skills/vercel-chat-sdk.md) — skill · 5400 installs
- [telegram-bot-builder](https://affpapa.org/en/nevibecode/skills/sickn33-telegram-bot-builder.md) — skill · 3700 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 205 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md