skills-for-ai
Empezar
Desarrollo Skill

Discord Bot Architect

Crea tu propio bot de Discord — de la idea a producción. Planifica, construye, revisa y amplía bots modernos contigo: slash commands, botones, modals modernos, Components V2, RGPD e integraciones como YouTube/Twitch. Arquitectura y seguridad incluidas — no solo fragmentos de código.

DiscordDiscord BotDiscord.jsSlash CommandsComponents V2ModalsButtonsSelect MenusOAuth2WebhooksApplication EmojisTypeScriptRGPDDiscord ModerationTicketsTwitchYouTubeRSSRate LimitsArquitectura de botsCrear un bot de DiscordProgramar un bot de DiscordDesarrollo de botsDiscord APIdiscord.pyPythonInteractionsIntentsGatewayEmbedsAutocompleteEventSubBot HostingDiscord Developer PortalApplication Commands
Gratis
0 ↓ 0 ★ 5,0 (1) v1.1.0 Actualizado 22.06.2026 por skills-for-ai

SKILL.md en el estándar abierto agentskills.io — funciona directamente en Claude, ChatGPT/Codex, Cursor, Copilot y más.

Discord Bot Architect es un skill de IA para el desarrollo de bots de Discord — tu compañero para crear tus propios bots de Discord, desde tu primer bot hasta un gran sistema comunitario. En lugar de fragmentos sueltos obtienes decisiones de arquitectura reales (¿bot o webhook?), slash commands limpios, botones, modals modernos y Components V2, además de permisos, protección de rate-limit y timeout, RGPD e integraciones (YouTube/Twitch/RSS). Entiende Discord como un sistema completo de producto, UI y API — del setup al despliegue.

Qué hace este skill

  • Te acompaña al crear tu propio bot de Discord — desde tu primer bot hasta un sistema complejo: setup y Developer Portal, slash commands, botones y modals hasta el despliegue; primero planifica, luego programa.
  • Detecta el objetivo del producto y deduce lo que realmente hace falta: bot real o webhook, slash commands, botones/selectores/modals, Components V2, BD, jobs, APIs externas, flujo RGPD, actividad.
  • Diseña planes de bot completos en un formato fijo (objetivo → enfoque → bot/webhook/actividad → flujo UX → comandos → componentes → modelo de datos → seguridad → RGPD → límites → timeout → emoji → estructura → código → pruebas → riesgos → Definition of Done).
  • Construye una UI de Discord moderna: Components V2 / ContainerBuilder V2, secciones, galerías de medios, modals modernos (incl. selectores y subida de archivos), botones y menús de selección con un enrutado custom_id limpio.
  • Comprueba los payloads frente a los límites (presupuestos de componentes/embed/modal) y avisa pronto — incluidos scripts de validación ejecutables.
  • Hace cada arquitectura resistente a timeouts (regla de los 3 segundos, defer, colas) y eficiente en recursos (rate limits, caché, paginación, deduplicación).
  • Activa un modo RGPD para datos de usuario / UE: mapa de datos, finalidad/base legal/conservación, slash commands de privacidad (info/consent/optout/export/delete).
  • Planifica integraciones (YouTube/Twitch/RSS/n8n/Zapier/Make) con push/EventSub en lugar de polling agresivo, protección anti-duplicados y cooldowns.
  • Migra embeds antiguos a Components V2, domina moderación/bienvenida/tickets/publicaciones programadas/IA, y solo recomienda Activities cuando los componentes de mensaje son la herramienta equivocada.

Descripción

Discord Bot Architect es un skill para crear bots de Discord — te ayuda a planificar, programar, revisar y ampliar tus propios bots de Discord. No es un simple generador de fragmentos de código, sino un arquitecto: primero detecta qué estás construyendo en realidad, decide entre bot, webhook o Activity, diseña un flujo UX seguro ante timeouts y consciente de los límites, y solo entonces produce código listo para producción. Cubre todo el espectro — Discord Developer Portal y OAuth2, tokens/secretos/ENV, desarrollo local y despliegue, ciclo de vida de los slash commands (activar/desactivar/eliminar, guild vs global), ciclo de vida de las interacciones con protección defer/timeout, Components V2 / ContainerBuilder V2, modals modernos (selects, subida de archivos, casillas), botones/selects con enrutado custom_id, componentes basados en base de datos, embeds, registro de Application Emojis, permisos/intents/jerarquía de roles, rate limits/rendimiento/colas, RGPD con un mapa de datos y slash commands de privacidad, moderación, bienvenida/onboarding, tickets, publicaciones programadas, integración de IA y Activities/Embedded App SDK. Reglas base: la API de Discord es la fuente de la verdad y discord.js es solo una capa de comodidad; verificar las funciones nuevas en la documentación oficial; mantener la runtime ligera (la planificación va en docs/ o en memoria, no en la config de runtime); la seguridad primero (sin spam/scam/MD masivo/raid — alternativas en opt-in en su lugar). Incluye 50 archivos de referencia, scripts de validación ejecutables (comprobación de presupuestos payload/embed/modal/componentes, lint de custom_id, manifiesto de comandos, URL OAuth, seguridad ENV, riesgo de privacidad, riesgo de timeout, briefs de emoji) y ejemplos genéricos de TypeScript (discord.js v14). Compra única, se ejecuta en local con tu propia IA.

Ejemplos

Revisión de seguridad: DM masivo → opt-in
Quiero que mi bot envíe un DM a cada miembro cuando subamos un vídeo nuevo, para que nadie se lo pierda.
Tú 17 de julio de 2026
Discord Bot Architect

No voy a construir el envío de DM a todos los miembros — Discord lo considera spam, el bot acaba con rate-limit y baneado, y es malo para tu comunidad. Mismo resultado, seguro y mejor:

  • Rol de anuncios opt-in + un canal de Anuncios. Los miembros se lo asignan ellos mismos con un botón.
  • Ante cada subida nueva, publica un solo mensaje en ese canal y menciona el rol con allowed_mentions: { roles: ["<id>"] } (así solo se menciona ese rol, nada más).
  • Superficie: un webhook basta para la *publicación*, pero necesitas un bot para el botón de opt-in → así que bot-first. Deduplica por videoId para que un nuevo sondeo nunca publique dos veces.

¿Quieres el plan completo (flujo de rol por botón + vigilancia de subidas de YouTube con deduplicación + publicación con rate-limit)?

Capacidad/decisión: ¿un modal desde un webhook?
¿Puedo abrir un modal desde un webhook cuando alguien hace clic en un botón?
Tú 17 de julio de 2026
Discord Bot Architect

No. Un modal debe enviarse como respuesta a una interacción (interaction.showModal(...)), y un simple webhook entrante no puede ni recibir un clic de botón ni responder con un modal. El clic es una interacción que va a tu app (bot por gateway o endpoint de interacciones HTTP) — esa es la que responde con el modal.

  • Botón → interacción → tu bot → showModal() → el usuario envía → interacción modal-submit → haces deferReply/reply.
  • Los webhooks solo pueden *enviar* (content/embeds/files). Todo lo interactivo necesita el bot.
  • Ojo con los límites del modal: 1 a 5 componentes de nivel superior, custom_id ≤ 100 caracteres, sin botones/contenedores dentro.
Protección de timeout: comando slash lento (regla de los 3 segundos)
Mi /report ejecuta una consulta a la base de datos y Discord a veces muestra « La aplicación no respondió ». ¿Qué estoy haciendo mal?
Tú 17 de julio de 2026
Discord Bot Architect

Discord espera una confirmación en ~3 s, o el token de interacción caduca. Una consulta a la base puede tardar más → difiere primero con deferReply(), luego haz el trabajo y complétalo con editReply() (el token sigue válido ~15 min después).

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}`);
}

Regla general: respuesta trivial → reply() directamente; todo lo que toque base/API → deferReply() + editReply(). Nunca ambos para la misma interacción.

Flujo de modal: formulario de dos campos + handler de envío
¿Cómo abro un formulario (título + descripción) al hacer clic en un botón y leo las entradas?
Tú 17 de julio de 2026
Discord Bot Architect

Un modal es una respuesta a una interacción y debe ser la primera respuesta (sin defer/reply previo). Cada campo de texto va en su propia ActionRow; al enviar lees los campos por custom_id.

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');

Límites: 1 a 5 componentes de nivel superior, solo campos de texto/selects (sin botones), custom_id ≤ 100 caracteres — no codifiques datos sensibles.

Components V2: anuncio como Container (en vez de un embed)
Quiero un anuncio moderno con título, texto, un separador y dos botones — sin embed clásico.
Tú 17 de julio de 2026
Discord Bot Architect

Components V2 sustituye los embeds por un ContainerBuilder. Importante: un mensaje V2 nunca lleva content ni embeds — solo components + el flag IsComponentsV2.

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

Comprobación con el payload en crudo para el renderizador: Container = tipo 17, Text Display = 10, Separator = 14, Action Row = 1.

1 / 5

Qué no hace

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

Compatibilidad y técnica

Claude (Projects & system prompt) & Claude CodeChatGPT/Codex, Cursor, Copilot, Gemini CLI, Windsurf, Cline (SKILL.md/paste-in)Stack-agnostic; examples in TypeScript + discord.js v14; optional Node validator scripts
Probado (interno)
6 escenarios
Runtime recomendado
Cualquier modelo de chat capaz; especialmente fluido en herramientas con contexto de archivos/proyecto (Claude Code, Cursor, etc.) porque el skill puede usar sus referencias, scripts de validación y ejemplos directamente en el repositorio.
Modos
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
Entradas
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)
Formato de salida
Uno de 14 modos de respuesta según la petición: respuesta de capacidad breve, plan de bot completo (17 secciones), diseño de payload, revisión de código, comprobación de límites/presupuesto, decisión bot-vs-webhook, flujo de modal, mapa de datos de privacidad, plan de integración o revisión de seguridad — limpio, con notas de límites/timeout/spam.
Subcategoría
Discord / Desarrollo de bots
Licencia
Proprietär

Perfil de seguridad

Local

Se ejecuta por completo en tu equipo con tu propia IA — sin runtime externo, sin costes recurrentes.

Contiene scripts

Contiene código ejecutable o ejecuta acciones/herramientas — échale un vistazo antes de usar.

Sin acceso a la red

Funciona sin conexión con lo que proporcionas — no llama a servicios externos por sí mismo.

¿Qué significan estas insignias? →

Qué incluye

  • discord-bot-architect-1.1.0/117 archivos
    • .claude-plugin/marketplace.json
    • plugins/discord-bot-architect/skills/discord-bot-architect/117 archivos
      • SKILL.md
      • README.md
      • AGENTS.md
      • manifest.json
      • docs/10 archivos
        • 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 archivos
        • activities/1 archivo
          • README.md
        • assets/4 archivos
          • emoji-assets.todo.md
          • emojiRegistry.json
          • emojiResolver.ts
          • ui-icon-guidelines.md
        • command-registration/5 archivos
          • bulk-overwrite.ts
          • delete-command.ts
          • disable-command-default-permissions.ts
          • register-global-commands.ts
          • register-guild-commands.ts
        • components-v2/4 archivos
          • button-action-row.ts
          • container-announcement.ts
          • media-gallery.ts
          • section-with-thumbnail.ts
        • integrations/4 archivos
          • rss-announcement.ts
          • scheduled-event-reminder.ts
          • twitch-eventsub-live-alert.ts
          • youtube-websub-upload-alert.ts
        • interactions/4 archivos
          • button-router.ts
          • custom-id-parser.ts
          • modal-router.ts
          • safe-defer-pattern.ts
        • modals/4 archivos
          • modal-checkbox-consent.ts
          • modal-file-upload.ts
          • modal-string-select.ts
          • modal-text-input.ts
        • privacy/4 archivos
          • consent-flow.ts
          • delete-user-data.ts
          • export-user-data.ts
          • privacy-command.ts
        • starter-typescript-discordjs/9 archivos
          • .env.example
          • package.json
          • tsconfig.json
          • src/6 archivos
            • app/4 archivos
              • client.ts
              • config.ts
              • deployCommands.ts
              • interactionRouter.ts
            • shared/2 archivos
              • ui/2 archivos
                • emojis/2 archivos
                  • emojiRegistry.json
                  • emojiResolver.ts
      • references/52 archivos
        • 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 archivos
        • 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 — mismo contenido (Codex, Cursor, Copilot, Gemini, Windsurf, Cline)
    • LICENSE.txt

Instalación

Tras desbloquear, instalas con un solo comando — detecta tu herramienta de IA.

Funciona enClaude CodeGitHub CopilotGemini CLICursorCodex CLIWindsurfCline

También como prompt de chat

Método en chat

¿Sin herramienta de IA? Pégalo en Claude, ChatGPT o Gemini y usa el método al instante.

Obtienes el método completo. Solo 12 script(s) de ayuda que automatizan partes funcionan una vez instalado.

Instalarlo es la versión completa — se activa solo, ejecuta sus scripts y carga referencias cuando hacen falta. Como prompt de chat, tú conduces el método.

Desbloquéalo para copiar el prompt listo para pegar — luego en «Mis skills».

Reseñas

5,0 1 reseña

Nota

Skill experto genérico — no copia nada de un proyecto de bot existente. Los ejemplos son TypeScript + discord.js v14; la metodología es independiente del stack (también Python/Go/Rust/HTTP puro). Los valores de la API de Discord pueden cambiar — el skill recomienda comprobar la documentación para funciones nuevas.

Historial de cambios

  • v1.1.022.06.2026Salida nativa de la plataforma: ahora usa activamente el formato nativo de tu plataforma — tablas, listas de control, bloques de código y opciones clicables/botón, con alternativa numerada en plataformas no interactivas. Además, metadatos internos que preparan el próximo constructor de agentes.
  • 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.

Preguntas frecuentes

¿Qué hace Discord Bot Architect?

Discord Bot Architect es un skill de IA para el desarrollo de bots de Discord — tu compañero para crear tus propios bots de Discord, desde tu primer bot hasta un gran sistema comunitario. En lugar de fragmentos sueltos obtienes decisiones de arquitectura reales (¿bot o webhook?), slash commands limpios, botones, modals modernos y Components V2, además de permisos, protección de rate-limit y timeout, RGPD e integraciones (YouTube/Twitch/RSS). Entiende Discord como un sistema completo de producto, UI y API — del setup al despliegue.

¿Cómo creo un bot de Discord?

En resumen: crea una app + bot en el Discord Developer Portal, guarda el token de forma segura, invita al bot vía OAuth2, registra los slash commands, desarrolla en local y luego despliega. Discord Bot Architect te guía en cada paso para crear tu bot de Discord y escribe el código contigo — TypeScript + discord.js por defecto, pero independiente del stack.

¿Qué lenguaje y librería necesito?

Lo recomendado es TypeScript + discord.js v14, pero el skill es independiente del stack (también Python/discord.py, Go o interacciones HTTP en crudo). La API de Discord es la fuente de la verdad; si una librería va por detrás de una función, el skill te da el payload en crudo adecuado.

¿Necesito experiencia programando?

El skill es para desarrolladores de todos los niveles — desde tu primer bot hasta un sistema comunitario complejo. Guía a principiantes en el setup, el token y los primeros slash commands; a los avanzados les aporta arquitectura, límites, protección de timeout/rate-limit y casos límite.

¿Admite slash commands, botones, modals y Components V2?

Sí — toda la UI moderna de Discord: ciclo de vida de slash commands (crear/activar/eliminar), botones y menús de selección con enrutado custom_id, modals modernos (Label, selects, subida de archivos) y Components V2 / ContainerBuilder — todo seguro ante timeouts y límites.

¿Dónde se ejecuta mi bot — y ayuda el skill con el hosting y el despliegue?

El skill se ejecuta en local con tu IA. Para el bot, planifica el desarrollo local y el despliegue en servidor (gestor de procesos, Docker, secretos/ENV, sharding) y decide si necesitas un bot real o un simple webhook.

¿Ayuda con el RGPD y con bots existentes?

Sí. Para datos de usuario / UE activa un modo de privacidad con un mapa de datos y slash commands de privacidad. Puede auditar y depurar bots existentes, migrar embeds legacy a Components V2 y ampliarlos con integraciones como YouTube/Twitch/RSS.

¿Con qué herramientas de IA funciona Discord Bot Architect?

Claude (Projects & system prompt) & Claude Code · ChatGPT/Codex, Cursor, Copilot, Gemini CLI, Windsurf, Cline (SKILL.md/paste-in) · Stack-agnostic; examples in TypeScript + discord.js v14; optional Node validator scripts

¿Cómo uso Discord Bot Architect?

Discord Bot Architect es un SKILL.md en el estándar abierto agentskills.io: instálalo con un comando (npx) o descárgalo y añádelo a tu herramienta de IA — Claude (Projects), ChatGPT (Custom GPT), Cursor, Copilot, Gemini CLI y más. Sin código.