Communitygithub.com

html5-display-ads

Crie anúncios gráficos HTML5 animados e prontos para produção (banners) para o Google Ads / Rede de Display do Google e outros servidores de anúncios, um ZIP por tamanho, com rastreamento de clique clickTag, a partir de um vídeo, quadros do Figma, exportações PNG ou um briefing.

O que é html5-display-ads?

Esta skill constrói um conjunto de banners HTML5 animados, um ZIP independente por tamanho, que passam nas verificações HTML5 do Google Ads. Ela é ideal para desenvolvedores e profissionais de marketing que precisam criar, redimensionar, recortar ou re-marcar anúncios gráficos para o Google Display Network, GDN ou outros servidores de anúncios. A skill suporta várias plataformas (Google Ads, GDN) e fontes de design (Figma, vídeos, exportações PNG, briefings). O fluxo de trabalho inclui ingestão inteligente de requisitos (tamanhos, cópia, CTA), obtenção de artefatos de alta resolução (arquivos oficiais, Figma, quadros de vídeo), layout preciso por tamanho (combinando ou derivando de referências), preparação de ativos otimizados (imagens 2x/3x, JPG com qualidade controlada), construção via scripts automatizados com uma estrutura de anúncio consistente (meta ad.size, clickTag, timeline CSS, hook #end), verificação de qualidade rigorosa (QA) com checagens de meta, clickTag, balanceamento de chaves, imagens quebradas, tamanho de arquivo (≤150 KB), e geração de pré-visualizações em MP4/GIF. A entrega final inclui um ZIP por tamanho e um pacote completo com README e visão geral.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Anúncios gráficos HTML5

Constrói um conjunto de banners HTML5 animados, um ZIP independente por tamanho, que passam nas verificações HTML5 do Google Ads. Os scripts em scripts/ fazem o trabalho mecânico (construção, QA, pré-visualização, preparação de imagem); seu trabalho é acertar as fontes e os layouts, que é onde quase toda a iteração acontece.

Leia references/google-ads-html5.md antes da primeira construção (limites, clickTag, tamanhos, etapas de upload). Leia references/sources-and-figma.md assim que a solicitação envolver Figma, um vídeo ou quadros exportados. Leia references/spec-format.md ao escrever especificações de layout. references/example-closet-world-bf2026.md é um exemplo completo (21 tamanhos) para copiar padrões.

Se scripts/ e references/ não estiverem ao lado deste arquivo (por exemplo, apenas SKILL.md foi enviado), siga o mesmo fluxo de trabalho manualmente: escreva o index.html de cada anúncio com a mesma estrutura (meta ad.size, var clickTag no head, uma saída window.open(window.clickTag) para todo o anúncio, linha do tempo de classe CSS, hook #end, borda de 1px), zip cada tamanho com index.html na raiz e execute as mesmas verificações em um navegador headless.

Se o trabalho for para uma marca com sua própria skill de sistema de design (por exemplo, cw-foundations e cw-social da Closet World), leia essa skill também: ela define regras de logotipo, cor, tipo e cópia. Esta skill define o formato do anúncio.

Fluxo de trabalho

1. Entrada (pergunte apenas o que você não pode inferir)

Obtenha: os tamanhos (se o usuário disser "todos os tamanhos" ou não nomear nenhum, use o conjunto padrão de 20 tamanhos abaixo); a oferta e o texto do título; a redação do CTA; a URL de clique (um padrão é aceitável, porque o Google Ads substitui clickTag pela URL final); e a fonte da verdade para o design: um corte de vídeo, quadros do Figma, exportações PNG ou nada (então você projeta a partir do briefing e das regras da marca). Verifique os uploads você mesmo: um arquivo mencionado pelo usuário pode não ter chegado. Procure em /mnt/user-data/uploads.

Conjunto padrão (20 tamanhos). Quadrado: 200x200, 240x400, 250x250, 250x360, 300x250, 336x280, 580x400. Arranha-céu: 120x600, 160x600, 300x600, 300x1050. Leaderboard: 468x60, 728x90, 930x180, 970x90, 970x250, 980x120. Mobile: 300x50, 320x50, 320x100. Mantenha esta lista em uma variável e construa a partir dela, para que nenhum tamanho seja esquecido entre as rodadas.

2. Fontes: obtenha a arte real, com resolução suficiente

A qualidade de cada anúncio depende desta etapa. Em ordem de preferência:

  1. Arquivos oficiais que o usuário envia (logotipo, lockups, fotos). Peça por nome da camada e escala de exportação.
  2. Figma através do conector: get_metadata fornece tamanhos dos quadros e coordenadas das camadas; get_screenshot com enableBase64Response permite que você veja um quadro. Downloads de figma.com geralmente são bloqueados no sandbox (curl exit 6), então você normalmente não pode salvar pixels do Figma. Peça ao usuário para exportar camadas específicas.
  3. Quadros de vídeo (layers.py frames), com arte extraída de fundos planos (layers.py key) e produtos recortados (layers.py cutout --region). Eles são nítidos (1080 px), mas com enquadramento apertado.
  4. Exportações de quadros 1x do usuário: enquadramento exato, mas suaves. Combine-os com uma fonte mais nítida (layers.py find localiza um recorte dentro de uma imagem mais nítida; layers.py blend mescla uma renderização nítida em uma exportação suave).

Sempre diga claramente de onde veio cada ativo e o que custa (por exemplo, "logotipo extraído do vídeo, então está mais suave; envie o arquivo oficial para corrigir"). Os usuários notam logotipos suaves primeiro.

3. Layout por tamanho

  • Quando existir um quadro Figma ou quadro exportado para um tamanho, combine-o exatamente. Meça as posições a partir do PNG (sequências de cores para painéis, caixas delimitadoras de alfa ou não-fundo para arte); não olhe de relance. Verifique o tamanho real em pixels do PNG: os quadros podem ser nomeados errados (um "120x600" exportado com 160 de largura, um "970x90" desenhado com 960). Construa no tamanho do Google, coloque quaisquer pixels extras em algum lugar neutro (um painel sólido) e informe.
  • Quando um tamanho não tiver quadro, derive-o do tamanho aprovado mais próximo na mesma família (veja references/spec-format.md para padrões de família), informe ao usuário que é sua adaptação e ofereça ajustes.
  • Os usuários geralmente enviam quadros por cena (quadro 1, 2, 3). Trate-os como a verdade por cena para fotos, recortes e qualquer elemento que se mova (por exemplo, um logotipo que fica mais baixo quando a tagline aparece).
  • Camadas do Figma invertidas relatam posições x confusas. Meça a partir da captura de tela ou exportação.

4. Preparar ativos

  • Imagens em 2x do tamanho CSS (fotos como JPG, qualidade 60-78), arte como PNGs de paleta (quantize, 16-64 cores). Logotipos em 3x (são no que as pessoas olham; layers.py logo faz isso).
  • Produtos que abrangem um fundo de duas cores: mescle cada cena no fundo do próprio anúncio largura total em uma linha de divisão de pixels inteiros, para que não haja costura visível onde a borda da imagem encontra o CSS.
  • Mantenha cada ZIP em ou abaixo de 150.000 bytes; reduza a qualidade JPG ou reduza fotos grandes para 1,5x se necessário.

5. Construir

Escreva uma especificação JSON por tamanho (references/spec-format.md), então:

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

Isso escreve build/300x250/index.html mais ativos e build/<prefix>_300x250.zip (arquivos na raiz do ZIP), e imprime bytes e contagem de arquivos. O modelo já possui: <meta name="ad.size">, var clickTag no head, uma saída para todo o anúncio window.open(window.clickTag), a linha do tempo de movimento compartilhada, uma borda de 1px, suporte a movimento reduzido e um hook de URL #end que salta para o quadro final.

O movimento (mantenha-o idêntico em todo o conjunto, a menos que solicitado): título entra (0,2 s), oferta aparece (0,9 s), cena 2 (2,4 s), cena 3 com troca de título para tagline (4,8 a 5,1 s), cartão final desliza para cima com oferta, logotipo e CTA (7,6 a 8,7 s), brilho do CTA; toca duas vezes, então descansa no cartão final por volta de 21 s (abaixo dos 30 s do Google).

6. QA (cada tamanho, toda vez)

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

Ele verifica a meta ad.size, declaração e saída do clickTag, equilíbrio de chaves CSS, página e erros de console, solicitações externas, imagens quebradas, elementos que transbordam para fora do anúncio, cartão final aparecendo, texto do CTA cortado, o clique abrindo a URL clickTag, o estado de repouso após duas reproduções, raiz do ZIP, bytes e contagem de arquivos. Corrija e execute novamente até que tudo passe. Em seguida, observe o resultado: renderize cada estado de cena (classes still s1 s2, still s1 s2 c2, still s1 s2 c2 c3 s3 e o final) e compare lado a lado com os quadros de referência. Uma diferença de pixel por região (zona esquerda, foto, oferta) mostra rapidamente o que está errado.

7. Pré-visualização

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

Isso grava um MP4 e GIF em velocidade real (reajusta o tempo da captura com um relógio na página). Verifique quatro quadros (cerca de 1,5, 3,4, 6,0 e 9,5 s) antes de apresentar: título e oferta, cena 2, tagline, cartão final.

8. Entrega

  • Verifique a cobertura primeiro: compare os nomes dos ZIPs entregues com a lista de tamanhos solicitada e construa qualquer coisa faltando antes de responder (um 250x250 uma vez sumiu por várias rodadas). Reexecute o QA em todo o conjunto após qualquer alteração em um ativo compartilhado (logotipo, oferta, modelo).
  • Um ZIP por tamanho, nomeado <Brand>_<Campaign>_<WxH>.zip, copiado para /mnt/user-data/outputs/ e apresentado com o GIF de pré-visualização primeiro. Se você reconstruir um ZIP, confirme que o conteúdo do arquivo entregue mudou (cmp um arquivo dentro dele), porque os timestamps podem parecer desatualizados.
  • Para um conjunto completo, também entregue um pacote de todos os tamanhos (README, uma imagem geral de cada tamanho e os ZIPs).
  • Na resposta: o que está em cada arquivo, o movimento em uma sequência curta, tamanhos em KB, quais layouts seguem os quadros Figma e quais são sua adaptação, e qualquer compromisso (fonte suave, redação do CTA alterada, 960 para 970).
  • Usuários iniciantes: explique que o arquivo HTML está dentro do ZIP, que eles enviam o próprio ZIP e que descompactar e clicar duas vezes em index.html faz a pré-visualização (as imagens devem permanecer ao lado dele).

Pegadinhas aprendidas da maneira mais difícil

  • Nomes de classe colidem com classes de estado. A linha do tempo adiciona c2/c3 ao #ad; nunca dê aos elementos esses nomes de classe (uma classe de imagem .c2{opacity:0} uma vez escondeu todo o anúncio). O modelo usa sc2/sc3.
  • Erros de chave matam as regras depois deles. Uma chave } perdida desabilitou silenciosamente o cartão final. O construtor e o QA ambos verificam o equilíbrio de chaves.
  • Codificações de vídeo deslocam cores ligeiramente; Figma é exato. Obtenha as cores da marca do Figma (get_design_context em uma camada sólida) ou da skill da marca, não de pixels de vídeo. Observe qualquer conflito entre os vermelhos do criativo e o padrão da marca em vez de silenciosamente "corrigi-lo".
  • A captura headless executa 10-35% lenta e irregularmente. Nunca confie no tempo bruto de uma gravação; use record_preview.py.
  • Texto com 50 px de altura. "Agende uma consulta gratuita" não cabe em um cartão final de 300x50; use um CTA curto ("Agende agora") lá e mantenha a redação completa onde couber. Avise o usuário.
  • O Google conta 150 KB. Mantenha-se em ou abaixo de 150.000 bytes para que ambas as leituras do limite passem.
  • Agrupamento de texto do CTA. Um rótulo ligeiramente mais largo que o espaço dentro do preenchimento permanece visível, mas fica descentralizado. O qa_ads.py avisa sobre isso; reduza o preenchimento do botão (14 para 10 px) ou o tamanho da fonte.
  • Alterações em ativos compartilhados afetam todos os ZIPs. Quando um logotipo ou lockup é substituído, reconstrua cada tamanho, reexecute o QA, substitua ou exclua pacotes antigos (por exemplo, um ZIP antigo de todos os tamanhos) e confirme que cada arquivo entregue mudou.
  • Pergunte uma vez, com precisão. Quando precisar de arquivos, liste as camadas exatas, quadros e escala de exportação em uma tabela, além da alternativa (um proprietário da organização pode colocar www.figma.com na lista de permitidos). Não pergunte novamente por algo já respondido.

Habilidades Relacionadas