Discord Bot API Skill (Advanced)

Purpose

Provide a production-oriented guide for building Discord bot workflows via the REST API and Interactions, focusing on professional command UX, safe operations, and direct HTTPS usage (no SDKs).

Best fit

• You want command-first bot behavior and clear interaction flows.
• You prefer direct HTTP requests without a library dependency.
• You need a structured map of Discord API surfaces.

Not a fit

• You need a full SDK or gateway client implementation.
• You plan to stream large media uploads directly.

Quick orientation

• Read references/discord-api-overview.md for base URL, versioning, and object map.
• Read references/discord-auth-and-tokens.md for token types and security boundaries.
• Read references/discord-interactions.md for interaction lifecycle and response patterns.
• Read references/discord-app-commands.md for slash, user, and message commands.
• Read references/discord-messages-components.md for messages, embeds, and components.
• Read references/discord-gateway-webhooks.md for gateway vs webhook tradeoffs.
• Read references/discord-rate-limits.md for throttling and header-based handling.
• Read references/discord-request-templates.md for HTTP payload templates.
• Read references/discord-feature-map.md for the full surface checklist.

Required inputs

• Bot token and application ID.
• Interaction endpoint public key (if using interaction webhooks).
• Command list and UX tone.
• Allowed intents and event scope.

Expected output

• A clear bot workflow plan, command design, and operational checklist.

Operational notes

• Prefer interactions and slash commands over prefix parsing.
• Always validate incoming interaction signatures.
• Keep payloads small and respond quickly to interactions.

Security notes

• Never log tokens or secrets.
• Use least-privilege permissions and scopes.