Discord Bot Architect

Ce que fait ce skill

• T’accompagne pour créer ton propre bot Discord — du premier bot au système complexe : setup & Developer Portal, slash commands, boutons & modals jusqu’au déploiement ; il planifie d’abord, code ensuite.
• Détecte l’objectif produit et en déduit ce qui est réellement nécessaire : vrai bot ou webhook, slash commands, boutons/sélecteurs/modals, Components V2, BDD, jobs, API externes, parcours RGPD, activité.
• Conçoit des plans de bot complets dans un format fixe (objectif → approche → bot/webhook/activité → flux UX → commandes → composants → modèle de données → sécurité → RGPD → limites → timeout → emoji → structure → code → tests → risques → Definition of Done).
• Construit une UI Discord moderne : Components V2 / ContainerBuilder V2, sections, galeries média, modals modernes (avec sélecteurs et upload de fichiers), boutons et menus de sélection avec un routage custom_id propre.
• Vérifie les payloads par rapport aux limites (budgets de composants/embed/modal) et avertit tôt — avec des scripts de validation exécutables.
• Rend chaque architecture résistante aux timeouts (règle des 3 secondes, defer, files d’attente) et économe en ressources (rate limits, cache, pagination, déduplication).
• Active un mode RGPD pour les données utilisateurs / l’UE : cartographie des données, finalité/base légale/conservation, slash commands de confidentialité (info/consent/optout/export/delete).
• Planifie les intégrations (YouTube/Twitch/RSS/n8n/Zapier/Make) avec push/EventSub plutôt qu’un polling agressif, protection anti-doublons et cooldowns.
• Migre les anciens embeds vers Components V2, connaît modération/accueil/tickets/posts programmés/IA, et ne recommande les Activities que lorsque les composants de message sont le mauvais outil.

Description

Discord Bot Architect est un skill pour créer un bot Discord — il t’aide à planifier, développer, auditer et étendre tes propres bots Discord. Pas un simple générateur de bouts de code, mais un architecte : il identifie d’abord ce que tu construis vraiment, tranche entre bot, webhook ou Activity, conçoit un flux UX sûr côté timeout et respectueux des limites, et ne produit qu’ensuite un code prêt pour la production. Il couvre tout le spectre — Discord Developer Portal & OAuth2, tokens/secrets/ENV, développement local & déploiement, cycle de vie des slash commands (activer/désactiver/supprimer, guild vs global), cycle de vie des interactions avec protection defer/timeout, Components V2 / ContainerBuilder V2, modals modernes (selects, upload de fichiers, cases à cocher), boutons/selects avec routage custom_id, composants pilotés par base de données, embeds, registre d’Application Emojis, permissions/intents/hiérarchie des rôles, rate limits/performance/files d’attente, RGPD avec carte des données et slash commands de confidentialité, modération, accueil/onboarding, tickets, posts programmés, intégration d’IA et Activities/Embedded App SDK. Règles de base : l’API Discord fait foi, discord.js n’est qu’une couche de confort ; vérifier les nouvelles fonctionnalités dans la doc officielle ; garder la runtime légère (la planification va dans docs/ ou en mémoire, pas dans la config runtime) ; la sécurité d’abord (pas de spam/scam/MP de masse/raid — des alternatives en opt-in à la place). Inclut 50 fichiers de référence, des scripts de validation exécutables (vérification des budgets payload/embed/modal/composants, lint custom_id, manifeste de commandes, URL OAuth, sécurité ENV, risque de confidentialité, risque de timeout, briefs emoji) et des exemples TypeScript génériques (discord.js v14). Achat unique, fonctionne en local avec ta propre IA.

Exemples

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],
});

Ce qu’il ne fait pas

• 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.

Compatibilité & technique

Testé (interne)

6 scénarios

Runtime recommandé

Tout modèle de chat capable ; particulièrement fluide dans les outils avec contexte fichier/projet (Claude Code, Cursor, etc.) car le skill peut utiliser ses références, scripts de validation et exemples directement dans le dépôt.

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

Entrées

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)

Format de sortie

L'un des 14 modes de réponse selon la demande : réponse de capacité courte, plan de bot complet (17 sections), conception de payload, revue de code, vérification de limites/budget, décision bot-vs-webhook, flux de modal, carte des données de confidentialité, plan d'intégration ou revue de sécurité — épuré, avec notes sur limites/timeout/spam.

Sous-catégorie

Discord / Développement de bots

Licence

Proprietär

Profil de sécurité

Contenu livré

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

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

      • 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 fichiers

      • activities/1 fichier

        • README.md
      • assets/4 fichiers

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

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

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

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

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

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

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

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

          • app/4 fichiers

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

            • ui/2 fichiers

              • emojis/2 fichiers

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

      • 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 fichiers

      • 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/→ universel — même contenu (Codex, Cursor, Copilot, Gemini, Windsurf, Cline)
  • LICENSE.txt

Installation

Aussi comme prompt de chat

Remarque

Skill expert générique — ne copie rien d'un projet de bot existant. Les exemples sont en TypeScript + discord.js v14 ; la méthodologie est indépendante de la stack (aussi Python/Go/Rust/HTTP brut). Les valeurs de l'API Discord peuvent changer — le skill recommande de vérifier la doc pour les nouvelles fonctionnalités.

Journal des modifications

• v1.1.022.06.2026Sortie native à la plateforme : utilise désormais activement le formatage natif de votre plateforme — tableaux, listes de contrôle, blocs de code et options cliquables/boutons, avec repli numéroté sur les plateformes non interactives. Et des métadonnées internes qui préparent le futur constructeur d'agents.
• 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.

Questions fréquentes