Communitygithub.com

anuncios-html5-display

Crea banners animados HTML5 listos para producción para Google Ads / Red de Display de Google y otros servidores de anuncios, un ZIP por tamaño, con seguimiento de clics clickTag, a partir de un video, fotogramas de Figma, exportaciones PNG o un brief.

¿Qué es anuncios-html5-display?

Esta habilidad automatiza la creación de banners animados HTML5 para Google Ads o cualquier servidor de anuncios que acepte el formato. Genera un archivo ZIP autónomo por cada tamaño de anuncio, todos pasando las verificaciones HTML5 de Google. Funciona a partir de múltiples fuentes de diseño: archivos Figma (mediante el conector), fotogramas de video, exportaciones PNG o incluso un brief textual. El flujo de trabajo incluye preparación de activos (redimensionamiento, cuantización de colores, optimización de peso por debajo de 150 KB), construcción con una plantilla que integra clickTag y animaciones CSS, pruebas de calidad automatizadas (QA) con comprobación de metadatos, enlaces, imágenes rotas y desbordamiento visual, y previsualización en MP4/GIF. La habilidad también maneja redimensionamientos, recortes y cambios de marca sobre conjuntos existentes, y se complementa con habilidades de sistema de diseño de marca si están disponibles. Está diseñada para entornos como Claude Code, Cursor o Codex, donde los scripts `scripts/` y las referencias `references/` están disponibles, pero también funciona manualmente con la misma estructura de archivos si solo se proporciona SKILL.md.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mgunther60/claude-skills-html/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Anuncios HTML5 display

Crea un conjunto de banners HTML5 animados, un ZIP autónomo por tamaño, que pasan las verificaciones HTML5 de Google Ads. Los scripts en scripts/ hacen el trabajo mecánico (construcción, QA, vista previa, preparación de imágenes); tu trabajo es conseguir las fuentes y diseños correctos, que es de donde proviene casi todo el ir y venir.

Lee referencias/google-ads-html5.md antes de la primera construcción (límites, clickTag, tamaños, pasos de subida). Lee referencias/fuentes-y-figma.md tan pronto como la solicitud involucre Figma, un video o fotogramas exportados. Lee referencias/formato-especificacion.md al escribir especificaciones de diseño. referencias/ejemplo-closet-world-bf2026.md es un ejemplo completo (21 tamaños) para copiar patrones.

Si scripts/ y referencias/ no están junto a este archivo (por ejemplo, solo se subió SKILL.md), sigue el mismo flujo de trabajo manualmente: escribe el index.html de cada anuncio con la misma estructura (meta ad.size, var clickTag en el head, una salida window.open(window.clickTag) para todo el anuncio, línea de tiempo con clases CSS, gancho #end, borde de 1px), comprime cada tamaño con index.html en la raíz y ejecuta las mismas comprobaciones en un navegador sin interfaz gráfica.

Si el trabajo es para una marca con su propia habilidad de sistema de diseño (por ejemplo, cw-foundations y cw-social de Closet World), lee también esa habilidad: ella decide las reglas de logotipo, color, tipografía y copia. Esta habilidad decide el formato del anuncio.

Flujo de trabajo

1. Recopilación (pregunta solo lo que no puedas inferir)

Obtén: los tamaños (si el usuario dice "todos los tamaños" o no nombra ninguno, usa el conjunto estándar de 20 tamaños a continuación); la oferta y el texto del titular; la redacción del CTA; la URL de clic (un valor predeterminado está bien, porque Google Ads reemplaza clickTag con la URL final); y la fuente de verdad para el diseño: un corte de video, fotogramas de Figma, exportaciones PNG, o nada (entonces diseñas a partir del brief y las reglas de la marca). Revisa las subidas tú mismo: es posible que un archivo mencionado por el usuario no haya llegado. Busca en /mnt/user-data/uploads.

Conjunto estándar (20 tamaños). Cuadrado: 200x200, 240x400, 250x250, 250x360, 300x250, 336x280, 580x400. Rascacielos: 120x600, 160x600, 300x600, 300x1050. Banners horizontales: 468x60, 728x90, 930x180, 970x90, 970x250, 980x120. Móvil: 300x50, 320x50, 320x100. Mantén esta lista en una variable y construye a partir de ella, para que ningún tamaño se pierda entre rondas.

2. Fuentes: obtén el material gráfico real, con suficiente resolución

La calidad de cada anuncio depende de este paso. En orden de preferencia:

  1. Archivos oficiales que el usuario suba (logotipo, lockups, fotos). Pídelos por nombre de capa y escala de exportación.
  2. Figma a través del conector: get_metadata da los tamaños de los fotogramas y las coordenadas de las capas; get_screenshot con enableBase64Response te permite ver un fotograma. Las descargas de figma.com suelen estar bloqueadas en la zona de pruebas (curl exit 6), por lo que normalmente no puedes guardar píxeles de Figma. Pide al usuario que exporte capas específicas.
  3. Fotogramas de video (layers.py frames), con material gráfico extraído de fondos planos (layers.py key) y productos recortados (layers.py cutout --region). Son nítidos (1080 px) pero encuadrados de forma ajustada.
  4. Exportaciones de fotogramas a 1x del usuario: encuadre exacto, pero suaves. Combínalos con una fuente más nítida (layers.py find localiza un recorte dentro de una imagen más nítida; layers.py blend fusiona un render nítido en una exportación suave).

Di siempre claramente de dónde proviene cada activo y qué costo tiene (por ejemplo, "logotipo extraído del video, por lo que es más suave; envía el archivo oficial para solucionarlo"). Los usuarios notan primero los logotipos suaves.

3. Diseño por tamaño

  • Cuando exista un fotograma de Figma o un fotograma exportado para un tamaño, ajústalo exactamente. Mide las posiciones a partir del PNG (ejecuciones de color para paneles, cuadros delimitadores alfa o de no fondo para arte); no calcules a ojo. Verifica el tamaño real en píxeles del PNG: los fotogramas a menudo se nombran incorrectamente (un "120x600" exportado a 160 de ancho, un "970x90" dibujado a 960). Construye al tamaño de Google, coloca los píxeles extra en algún lugar neutral (un panel sólido) y dímelo.
  • Cuando un tamaño no tenga fotograma, derívalo del tamaño aprobado más cercano en la misma familia (consulta referencias/formato-especificacion.md para patrones de familia), informa al usuario que es tu adaptación y ofrece ajustarlo.
  • Los usuarios a menudo envían fotogramas por escena (fotograma 1, 2, 3). Trátalos como la verdad por escena para fotos, recortes y cualquier elemento que se mueva (por ejemplo, un logotipo que se sitúa más abajo cuando aparece el eslogan).
  • Las capas invertidas de Figma reportan posiciones x confusas. Mide a partir de la captura de pantalla o la exportación.

4. Preparar activos

  • Imágenes a 2x del tamaño CSS (fotos como JPG, calidad 60-78), material gráfico como PNGs con paleta (quantize, 16-64 colores). Logotipos a 3x (son lo que la gente mira; layers.py logo hace esto).
  • Productos que cruzan un fondo de dos colores: aplana cada escena sobre el fondo propio del anuncio a ancho completo en una fila de división de píxeles enteros, para que no haya una costura visible donde el borde de una imagen se encuentra con el CSS.
  • Mantén cada ZIP en o por debajo de 150,000 bytes; reduce la calidad JPG o baja las fotos grandes a 1.5x si es necesario.

5. Construir

Escribe una especificación JSON por tamaño (referencias/formato-especificacion.md), luego:

python scripts/build_ad.py especificaciones/300x250.json --assets prepared/300x250 --out build

Escribe build/300x250/index.html más activos y build/<prefijo>_300x250.zip (archivos en la raíz del ZIP), e imprime bytes y número de archivos. La plantilla ya tiene: <meta name="ad.size">, var clickTag en el head, una salida para todo el anuncio window.open(window.clickTag), la línea de tiempo de movimiento compartida, un borde de 1px, soporte para movimiento reducido y un gancho de URL #end que salta al fotograma final.

El movimiento (mantenlo idéntico en todo un conjunto a menos que se pida lo contrario): titular entra (0.2 s), oferta aparece (0.9 s), escena 2 (2.4 s), escena 3 con intercambio de titular por eslogan (4.8 a 5.1 s), tarjeta final se desliza hacia arriba con oferta, logotipo y CTA (7.6 a 8.7 s), brillo del CTA; se reproduce dos veces, luego permanece en la tarjeta final alrededor de 21 s (por debajo de los 30 s de Google).

6. QA (cada tamaño, cada vez)

python scripts/qa_ads.py build/300x250 build/728x90 --zips build/*.zip --timing

Comprueba el meta ad.size, la declaración y salida de clickTag, el equilibrio de llaves CSS, errores de página y consola, solicitudes externas, imágenes rotas, elementos que se salen del anuncio, visualización de la tarjeta final, recorte de texto del CTA, el clic que abre la URL de clickTag, el estado de reposo después de dos reproducciones, la raíz del ZIP, bytes y número de archivos. Corrige y vuelve a ejecutar hasta que todo pase. Luego mira el resultado: renderiza cada estado de escena (clases still s1 s2, still s1 s2 c2, still s1 s2 c2 c3 s3, y el final) y compáralo lado a lado con los fotogramas de referencia. Una diferencia de píxeles por región (zona izquierda, foto, oferta) muestra rápidamente qué está mal.

7. Vista previa

python scripts/record_preview.py build/300x250 build/728x90 --out outputs/nombre_vista_previa --zoom 2

Esto escribe un MP4 y un GIF a velocidad real (reajusta el tiempo de captura con un reloj en la página). Verifica cuatro fotogramas (alrededor de 1.5, 3.4, 6.0 y 9.5 s) antes de presentar: titular y oferta, escena 2, eslogan, tarjeta final.

8. Entrega

  • Primero verifica la cobertura: compara los nombres de los ZIP entregados con la lista de tamaños solicitados y construye cualquier cosa que falte antes de responder (una vez faltó un 250x250 durante varias rondas). Vuelve a ejecutar QA en todo el conjunto después de cualquier cambio en un activo compartido (logotipo, oferta, plantilla).
  • Un ZIP por tamaño, nombrado <Marca>_<Campaña>_<WxH>.zip, copiado a /mnt/user-data/outputs/ y presentado con el GIF de vista previa primero. Si reconstruyes un ZIP, confirma que el contenido del archivo entregado cambió (cmp un archivo dentro de él), porque las marcas de tiempo pueden parecer obsoletas.
  • Para un conjunto completo, entrega también un paquete de todos los tamaños (README, una imagen de resumen de cada tamaño y los ZIP).
  • En la respuesta: qué hay en cada archivo, el movimiento en una secuencia corta, tamaños en KB, qué diseños siguen los fotogramas de Figma y cuáles son tu adaptación, y cualquier compromiso (fuente suave, redacción del CTA cambiada, 960 a 970).
  • Usuarios primerizos: explica que el archivo HTML está dentro del ZIP, que suben el ZIP en sí y que descomprimirlo y hacer doble clic en index.html lo previsualiza (las imágenes deben permanecer junto a él).

Errores aprendidos a la fuerza

  • Los nombres de clase chocan con las clases de estado. La línea de tiempo añade c2/c3 a #ad; nunca des a los elementos esos nombres de clase (una clase de imagen .c2{opacity:0} ocultó una vez todo el anuncio). La plantilla usa sc2/sc3.
  • Los errores de llaves matan las reglas posteriores. Una llave } fuera de lugar deshabilitó silenciosamente la tarjeta final. El constructor y QA verifican ambos el equilibrio de llaves.
  • Las codificaciones de video cambian ligeramente los colores; Figma es exacta. Toma los colores de la marca de Figma (get_design_context en una capa sólida) o de la habilidad de la marca, no de los píxeles del video. Nota cualquier conflicto entre los rojos del creativo y el estándar de la marca en lugar de "corregirlo" silenciosamente.
  • La captura sin interfaz gráfica se ejecuta 10-35% más lento y de manera desigual. Nunca confíes en el tiempo bruto de una grabación; usa record_preview.py.
  • Texto con 50 px de altura. "Agenda una consulta gratuita" no cabe en una tarjeta final de 300x50; usa un CTA corto ("Reserva ahora") ahí y mantén la redacción completa donde quepa. Informa al usuario.
  • Google cuenta 150 KB. Mantente en o por debajo de 150,000 bytes para que cualquiera de las lecturas del límite pase.
  • Texto del CTA apiñado. Una etiqueta ligeramente más ancha que el espacio dentro del relleno permanece visible pero se siente descentrada. qa_ads.py advierte sobre esto; reduce el relleno del botón (14 a 10 px) o el tamaño de fuente.
  • Los cambios en activos compartidos afectan a cada ZIP. Cuando se reemplaza un logotipo o lockup, reconstruye cada tamaño, vuelve a ejecutar QA, reemplaza o elimina los paquetes obsoletos (por ejemplo, un ZIP antiguo de todos los tamaños) y confirma que cada archivo entregado cambió.
  • Pregunta una vez, con precisión. Cuando necesites archivos, enumera las capas exactas, fotogramas y escala de exportación en una tabla, más la alternativa (un propietario de la organización puede permitir www.figma.com en la lista blanca). No preguntes de nuevo por algo ya respondido.

Skills relacionados