# Build Production-Ready Discord Bots

Discord bots fail when interactions, intents, commands, and scaling are designed incorrectly. This skill provides Discord.js and Pycord patterns for reliable bot architecture.

## Install

```bash
npx skillstore add sickn33/discord-bot-architect
```

## Metadata

- Status: approved
- Slug: sickn33-discord-bot-architect
- Skillstore revision: r2
- Version status: missing
- Tree hash: 41191fee1537673ef41552f922bfe5a90f8776fdddebd06e905f766e1d9342dc
- Author: sickn33
- GitHub username: sickn33
- License: MIT
- Repository: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/discord-bot-architect
- Ref: f9e2c34b4f19c7f3e6b0a1e93227b5f77cc12526
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: scripts, external\_commands, network, filesystem, env\_access
- Quality score: 76
- Public page: https://skillstore.pages.dev/skills/sickn33-discord-bot-architect
- Manifest: https://skillstore.pages.dev/api/skills/sickn33-discord-bot-architect/manifest

## Capabilities

- Scaffolds Discord.js v14 and Pycord bot structures with command and event organization.
- Designs slash commands with registration, response timing, and error handling.
- Builds buttons, select menus, modals, embeds, and ephemeral interaction flows.
- Applies minimal gateway intents and environment-based token handling.
- Plans rate-limited bulk operations and deferred responses for slow work.
- Introduces sharding patterns for bots approaching Discord scale requirements.

## Use Cases

- Launch a First Community Bot: Create a small bot with slash commands, minimal intents, secure token loading, and clear project structure.
- Improve Interaction Reliability: Review deferrals, component handlers, registration workflows, errors, and rate limits before production release.
- Plan Bot Scaling: Prepare shard boundaries, cross-shard operations, and deployment practices for a growing multi-server bot.

## Prompt Templates

### Create a Starter Bot

```
Create a beginner Discord bot using [Discord.js v14 or Pycord]. Include one slash command, minimal intents, environment-based token loading, and basic error handling.
```

### Design an Interactive Command

```
Design a [command purpose] flow using buttons, selects, or a modal. Define response timing, validation, authorization, timeout behavior, and user-facing errors.
```

### Review Production Readiness

```
Review my Discord bot architecture for interaction timeouts, privileged intents, command registration, token safety, rate limits, and error handling. Prioritize concrete changes.
```

### Plan a Sharded Deployment

```
Design a sharding plan for [guild count] guilds and [workload]. Cover shard lifecycle, cross-shard data, rate limits, observability, failure recovery, and deployment boundaries.
```

## Limitations

- Provides architecture and examples but does not deploy or operate a Discord bot.
- Generated code still requires dependency-specific testing and version checks.
- Voice, persistence, payments, and hosting need separate implementation decisions.
- Users must provide application identifiers, permissions, tokens, and deployment constraints.

## Best Practices

- Acknowledge every interaction within three seconds and defer slow work immediately.
- Request only required gateway intents and keep bot tokens outside source control.
- Test commands in one guild before controlled global registration.

## Anti Patterns

- Do not hardcode bot tokens or expose them in browser code, logs, screenshots, or repositories.
- Do not register commands on every startup or repeatedly create them in loops.
- Do not block the event loop or request every privileged intent by default.

## Security Audit

- Audited at: 2026-07-23T22:21:37.37\+00:00
- Summary: All 184 static detections are false positives from documentation examples. Dynamic imports use fixed local project directories, shard spawning uses Discord.js ShardingManager, and credential examples use environment variables only for Discord authentication. No prompt injection, data exfiltration, shell execution, or reconnaissance intent was found.

## Stats

- Views: 94
- Downloads: 11
- Favorites: 0
- Popularity score: 0