Discord Bot Architect

What this skill does

• Guides you through building your own Discord bot — from your first bot to a complex system: setup & Developer Portal, slash commands, buttons & modals through to deployment; plans first, codes second.
• Detects the product goal and derives what is actually needed: real bot or webhook, slash commands, buttons/selects/modals, Components V2, DB, jobs, external APIs, GDPR flow, activity.
• Designs full bot plans in a fixed format (goal → approach → bot/webhook/activity → UX flow → commands → components → data model → security → GDPR → limits → timeout → emoji → structure → code → tests → risks → Definition of Done).
• Builds modern Discord UI: Components V2 / ContainerBuilder V2, sections, media galleries, modern modals (incl. selects & file upload), buttons & select menus with clean custom_id routing.
• Checks payloads against limits (component/embed/modal budgets) and warns early — including runnable validator scripts.
• Makes every architecture timeout-safe (3-second rule, defer, queues) and resource-frugal (rate limits, caching, pagination, dedupe).
• Activates GDPR mode for user data / EU: privacy data map, purpose/legal basis/retention, privacy slash commands (info/consent/optout/export/delete).
• Plans integrations (YouTube/Twitch/RSS/n8n/Zapier/Make) with push/EventSub instead of aggressive polling, duplicate protection and cooldowns.
• Migrates legacy embeds to Components V2, knows moderation/welcome/tickets/scheduled posts/AI, and recommends Activities only when message components are the wrong tool.

Description

Discord Bot Architect is a skill for Discord bot development — it helps you plan, build, review and extend your own Discord bots. Not a snippet generator but an architect: it first detects what you are really building, decides bot vs. webhook vs. activity, designs a timeout-safe, limit-aware UX flow, and only then produces production-lean code. It covers the whole spectrum — Developer Portal & OAuth2, tokens/secrets/ENV, local dev & deployment, slash-command lifecycle (enable/disable/delete, guild vs. global), interaction lifecycle with defer/timeout protection, Components V2 / ContainerBuilder V2, modern modals (selects, file upload, checkboxes), buttons/selects with custom_id routing, DB-driven components, embeds, an Application Emoji registry, permissions/intents/role hierarchy, rate limits/performance/queues, GDPR with a privacy data map and privacy slash commands, moderation, welcome/onboarding, tickets, scheduled posts, AI integration, and Activities/Embedded App SDK. Core rules: the Discord API is the source of truth and discord.js is only a convenience layer; verify new features against the official docs; keep runtime lean (planning lives in docs/ or memory, not in runtime config); safety first (no spam/scam/mass-DM/raid — opt-in alternatives instead). Includes 50 reference files, runnable validator scripts (payload/embed/modal/component-budget checks, custom_id lint, command manifest, OAuth URL, ENV safety, privacy risk, timeout risk, emoji briefs) and generic TypeScript examples (discord.js v14). One-time purchase, runs locally with your own AI.

Examples

export async function handleReport(
  interaction: ChatInputCommandInteraction,
) {
  // Acknowledge immediately — buys ~15 min.
  await interaction.deferReply({ flags: MessageFlags.Ephemeral });

  const data = await queryDatabase(); // may now take >3 s

  await interaction.editReply(`Report ready: ${data}`);
}

const modal = new ModalBuilder()
  .setCustomId(`feedback:submit:${entityId}`) // module:action:id, <=100 chars
  .setTitle('Send feedback')
  .addComponents(
    new ActionRowBuilder<TextInputBuilder>().addComponents(
      new TextInputBuilder().setCustomId('title')
        .setLabel('Title').setStyle(TextInputStyle.Short)
        .setRequired(true).setMaxLength(80),
    ),
  );

await interaction.showModal(modal); // MUST be the first response

// In the submit handler:
const title = submit.fields.getTextInputValue('title');

const row = new ActionRowBuilder<ButtonBuilder>().addComponents(
  new ButtonBuilder().setStyle(ButtonStyle.Link)
    .setLabel('Open').setURL(url),                   // Link: url, no custom_id
  new ButtonBuilder().setStyle(ButtonStyle.Primary)
    .setLabel('OK').setCustomId('announce:ack:123'), // custom_id, no url
);

const container = new ContainerBuilder()
  .addTextDisplayComponents(new TextDisplayBuilder().setContent(`# ${title}`))
  .addTextDisplayComponents(new TextDisplayBuilder().setContent(body))
  .addSeparatorComponents(new SeparatorBuilder())
  .addActionRowComponents(row);

await channel.send({
  flags: MessageFlags.IsComponentsV2, // = 1 << 15 (32768)
  components: [container],
});

What it does not do

• Does not build spam/scam/phishing/mass-DM/raid/mass-ping tools or rate-limit evasion — it refuses the harmful part and offers a safe opt-in alternative.
• Does not ship a Discord API client or run your bot — it designs, reviews and gives code; you run it.
• Does not invent current API numbers/capabilities from memory for edge features — it flags a docs-check and prefers raw payloads when library support is unclear.
• Does not bloat runtime config with planning metadata — plans live in docs/ or memory.
• Not a substitute for server-side permission checks: visibility is UX, permission checks are security.

Compatibility & tech

Tested (internal)

6 scenarios

Recommended runtime

Any capable chat model; especially smooth in tools with file/project context (Claude Code, Cursor, etc.) because the skill can use its references, validator scripts and examples directly in the repo.

Modes

Capability Answer · Architecture Plan · Payload Design · Code Review · Limit Check · Webhook-vs-Bot Decision · Modal Flow Design · DB-driven UI · Infrastructure Plan · Migration Advice · Privacy Data Map · Integration Plan · Product Experience Compiler · Safety Review

Inputs

Question/request in natural language ("Plan a GDPR-safe giveaway bot") · Existing bot code / payload (for review or limit check) · Legacy embed (for migration to Components V2) · Feature description (for architecture plan, privacy data map, integration)

Output format

One of 14 response modes depending on the request: a short capability answer, a full bot plan (17 sections), payload design, code review, limit/budget check, bot-vs-webhook decision, modal flow, privacy data map, integration plan or safety review — production-lean, with limit/timeout/spam notes.

Subcategory

Discord / Bot development

License

Proprietär

Security profile

What you get

• discord-bot-architect-1.1.0/117 files
  • .claude-plugin/marketplace.json
  • plugins/discord-bot-architect/skills/discord-bot-architect/117 files

    • SKILL.md
    • README.md
    • AGENTS.md
    • manifest.json
    • docs/10 files

      • architecture-decisions.md
      • command-lifecycle.md
      • component-budget-template.md
      • emoji-assets.todo.md
      • integration-map.md
      • privacy-data-map.md
      • project-memory-template.md
      • release-checklist.md
      • safety-and-anti-spam-policy.md
      • ui-icon-guidelines.md
    • examples/39 files

      • activities/1 file

        • README.md
      • assets/4 files

        • emoji-assets.todo.md
        • emojiRegistry.json
        • emojiResolver.ts
        • ui-icon-guidelines.md
      • command-registration/5 files

        • bulk-overwrite.ts
        • delete-command.ts
        • disable-command-default-permissions.ts
        • register-global-commands.ts
        • register-guild-commands.ts
      • components-v2/4 files

        • button-action-row.ts
        • container-announcement.ts
        • media-gallery.ts
        • section-with-thumbnail.ts
      • integrations/4 files

        • rss-announcement.ts
        • scheduled-event-reminder.ts
        • twitch-eventsub-live-alert.ts
        • youtube-websub-upload-alert.ts
      • interactions/4 files

        • button-router.ts
        • custom-id-parser.ts
        • modal-router.ts
        • safe-defer-pattern.ts
      • modals/4 files

        • modal-checkbox-consent.ts
        • modal-file-upload.ts
        • modal-string-select.ts
        • modal-text-input.ts
      • privacy/4 files

        • consent-flow.ts
        • delete-user-data.ts
        • export-user-data.ts
        • privacy-command.ts
      • starter-typescript-discordjs/9 files

        • .env.example
        • package.json
        • tsconfig.json
        • src/6 files

          • app/4 files

            • client.ts
            • config.ts
            • deployCommands.ts
            • interactionRouter.ts
          • shared/2 files

            • ui/2 files

              • emojis/2 files

                • emojiRegistry.json
                • emojiResolver.ts
    • references/52 files

      • 00-read-current-docs-first.md
      • 01-goal-detection.md
      • 02-language-and-stack-choice.md
      • 03-best-practice-project-structure.md
      • 04-memory-and-docs-vs-runtime.md
      • 05-developer-portal-oauth-install.md
      • 06-tokens-secrets-env.md
      • 07-local-dev-server-deployment.md
      • 08-slash-commands-registration.md
      • 09-slash-commands-disable-delete-permissions.md
      • 10-interactions-lifecycle-timeouts.md
      • 11-embeds-legacy-messages.md
      • 12-components-v2-containerbuilder.md
      • 13-component-budgeter.md
      • 14-component-layout-matrix.md
      • 15-buttons-selects-custom-id-routing.md
      • 16-modals-modern-components.md
      • 17-db-driven-components.md
      • 18-webhooks-bot-vs-webhook.md
      • 19-permissions-intents-role-hierarchy.md
      • 20-application-emojis-and-ui-icons.md
      • 21-discord-assets-and-graphics.md
      • 22-rate-limits-performance-queues.md
      • 23-discordjs-v14-patterns.md
      • 24-raw-discord-api-payloads.md
      • 25-testing-debugging.md
      • 26-discord-ui-qa-theme-mobile-accessibility.md
      • 27-migration-doctor-legacy-to-v2.md
      • 28-command-lifecycle-manager.md
      • 29-common-errors-and-fixes.md
      • 30-dsgvo-gdpr-privacy.md
      • 31-privacy-data-map-generator.md
      • 32-privacy-slash-command-patterns.md
      • 40-integrations-overview.md
      • 41-youtube.md
      • 42-twitch.md
      • 43-rss.md
      • 44-forms-crm.md
      • 45-n8n-zapier-webhooks.md
      • 46-moderation-automation.md
      • 47-welcome-onboarding.md
      • 48-ticket-support-systems.md
      • 49-scheduled-posts-campaigns.md
      • 50-ai-integration.md
      • 51-bot-product-modes.md
      • 52-discord-experience-compiler.md
      • 53-install-surface-strategy.md
      • 54-engagement-loop-designer.md
      • 55-account-linking-and-external-identity.md
      • 60-activities-and-embedded-app-sdk.md
      • 99-limits-cheatsheet.md
      • discord-bot-architect-checklist.md
    • scripts/12 files

      • check-command-manifest.mjs
      • check-custom-id-schema.mjs
      • check-env-safety.mjs
      • check-modal-payload.mjs
      • component-budget-report.mjs
      • count-embed-limits.mjs
      • generate-missing-emoji-briefs.mjs
      • generate-oauth-url.mjs
      • inspect-components-v2.mjs
      • interaction-timeout-risk.mjs
      • scan-privacy-risk.mjs
      • validate-discord-payload.mjs
  • .agents/skills/discord-bot-architect/→ universal — same content (Codex, Cursor, Copilot, Gemini, Windsurf, Cline)
  • LICENSE.txt

Installation

Also works as a chat prompt

Note

Generic expert skill — copies nothing from an existing bot project. Examples are TypeScript + discord.js v14; the methodology is stack-agnostic (also Python/Go/Rust/raw HTTP). Discord API numbers can change — the skill recommends a docs-check for new features.

Changelog

• v1.1.022.06.2026Platform-native output: now actively uses your platform's native formatting — tables, checklists, code blocks and clickable/button options, with a numbered fallback on non-interactive platforms. Plus internal metadata that prepares the upcoming agent builder.
• v1.0.021.06.2026Initial release: comprehensive Discord bot architecture skill per AUTHORING v2 — bot-first default, safety/anti-spam, stack choice (TS + discord.js v14), two project structures, runtime-vs-docs-vs-memory, Components V2 / ContainerBuilder V2, modern modals, slash-command lifecycle, timeout/rate-limit protection, GDPR with privacy data map, integrations (YouTube/Twitch/RSS/n8n), Activities. 50 references + paste-ready checklist, 12 runnable validator scripts, generic TS examples and internal evals.

Frequently asked questions