Discord Bot API Skill (Advanced)

Purpose

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.