Communitygithub.com

HTML5-Display-Anzeigen

Erstellt animierte HTML5-Banner für Google Ads / Google Display Network, ein ZIP pro Größe, mit clickTag-Tracking, basierend auf Video, Figma-Frames, PNG-Exporten oder einer Anzeigenanfrage.

Was ist HTML5-Display-Anzeigen?

Dieses Skill erzeugt produktionsreife, animierte HTML5-Display-Anzeigen (Banner) für den Google Ads / Google Display Network und andere Anzeigenserver. Es erstellt für jede angegebene Größe ein eigenes, in sich geschlossenes ZIP-Archiv, das die strengen HTML5-Prüfungen von Google Ads besteht. Der Workflow umfasst die Aufbereitung von Quellmaterial (Figma-Frames, Video-Standbilder, PNG-Exporte), die präzise Layout-Erstellung nach Maßgabe der Referenzvorlagen, die Generierung des HTML5-Codes mit korrekter clickTag-Integration und Motion-Timeline, eine automatisierte Qualitätssicherung sowie die Erstellung von Vorschau-GIFs/MP4s. Es unterstützt gängige Formate wie Quadrat (z. B. 300x250), Wolkenkratzer (z. B. 160x600), Leaderboard (z. B. 728x90) und Mobil (z. B. 320x50) und garantiert, dass jede ZIP-Datei unter 150 KB bleibt. Das Skill ist für Claude Code optimiert, lässt sich aber auch manuell replizieren, indem die gleichen Schritte befolgt werden.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht HTML5-Display-Anzeigen?

Erstellt einen Satz animierter HTML5-Banner, ein in sich geschlossenes ZIP pro Größe, die die HTML5-Prüfungen von Google Ads bestehen. Die Skripte in scripts/ erledigen die mechanische Arbeit (Build, QA, Vorschau, Bildvorbereitung); Ihre Aufgabe ist es, die Quellen und Layouts richtig zu bekommen – hier entstehen fast alle Rückfragen.

Lesen Sie references/google-ads-html5.md vor dem ersten Build (Limits, clickTag, Größen, Upload-Schritte). Lesen Sie references/sources-and-figma.md, sobald die Anfrage Figma, ein Video oder exportierte Frames betrifft. Lesen Sie references/spec-format.md beim Schreiben von Layout-Spezifikationen. references/example-closet-world-bf2026.md ist ein vollständiges durchgearbeitetes Beispiel (21 Größen), um Muster zu kopieren.

Wenn scripts/ und references/ nicht neben dieser Datei liegen (z. B. wurde nur SKILL.md hochgeladen), folgen Sie demselben Workflow von Hand: Schreiben Sie für jede Anzeige eine index.html mit derselben Struktur (ad.size meta, var clickTag im head, ein gesamtanzeigen-window.open(window.clickTag)-Exit, CSS-Klassen-Timeline, #end-Hook, 1px-Rahmen), packen Sie jede Größe in ein ZIP mit index.html im Wurzelverzeichnis und führen Sie dieselben Prüfungen in einem Headless-Browser durch.

Wenn die Arbeit für eine Marke mit eigenem Design-System-Skill ist (z. B. Closet Worlds cw-foundations und cw-social), lesen Sie auch dieses Skill: Es bestimmt Logo, Farbe, Typografie und Kopierregeln. Dieses Skill bestimmt das Anzeigenformat.

Workflow

1. Aufnahme (fragen Sie nur, was Sie nicht ableiten können)

Holen Sie ein: die Größen (sagt der Benutzer „alle Größen" oder nennt keine, verwenden Sie den standardmäßigen 20-Größen-Satz unten); den Angebots- und Überschriftentext; die CTA-Formulierung; die Click-through-URL (ein Standardwert ist in Ordnung, da Google Ads clickTag durch die endgültige URL ersetzt); und die Design-Quelle: ein Video- Schnitt, Figma-Frames, PNG-Exporte oder nichts (dann entwerfen Sie aus dem Briefing und den Markenregeln). Prüfen Sie Uploads selbst: Eine vom Benutzer erwähnte Datei ist möglicherweise nicht angekommen. Suchen Sie in /mnt/user-data/uploads.

Standardsatz (20 Größen). Quadrat: 200x200, 240x400, 250x250, 250x360, 300x250, 336x280, 580x400. Wolkenkratzer: 120x600, 160x600, 300x600, 300x1050. Leaderboard: 468x60, 728x90, 930x180, 970x90, 970x250, 980x120. Mobil: 300x50, 320x50, 320x100. Behalten Sie diese Liste in einer Variable und bauen Sie daraus, damit keine Größe zwischen den Runden verloren geht.

2. Quellen: Besorgen Sie die echten Artworks in ausreichender Auflösung

Die Qualität jeder Anzeige hängt von diesem Schritt ab. In der Reihenfolge der Präferenz:

  1. Offizielle Dateien, die der Benutzer hochlädt (Logo, Logokombinationen, Fotos). Fragen Sie danach nach Ebenenname und Exportmaßstab.
  2. Figma über den Connector: get_metadata liefert Framegrößen und Ebenenkoordinaten; get_screenshot mit enableBase64Response lässt Sie einen Frame sehen. Downloads von figma.com werden in der Sandbox oft blockiert (curl exit 6), daher können Sie Figma-Pixel normalerweise nicht speichern. Bitten Sie den Benutzer, bestimmte Ebenen stattdessen zu exportieren.
  3. Videoframes (layers.py frames), mit Artwork, das von flachen Hintergründen abgehoben wurde (layers.py key) und ausgeschnittenen Produkten (layers.py cutout --region). Diese sind scharf (1080 px), aber eng beschnitten.
  4. 1x-Frame-Exporte vom Benutzer: exakter Beschnitt, aber weich. Kombinieren Sie sie mit einer schärferen Quelle (layers.py find findet einen Ausschnitt in einem schärferen Bild; layers.py blend fügt eine scharfe Darstellung in einen weichen Export ein).

Sagen Sie immer klar, woher jedes Asset stammt und was es kostet (z. B. „Logo aus dem Video entnommen, daher weicher; senden Sie die offizielle Datei zur Korrektur"). Benutzer bemerken weiche Logos zuerst.

3. Layout pro Größe

  • Wenn ein Figma-Frame oder exportierter Frame für eine Größe existiert, gleichen Sie ihn exakt an. Messen Sie Positionen aus dem PNG (Farbverläufe für Panels, Alpha- oder Nicht-Hintergrund-Bounding-Boxes für Artwork); schätzen Sie nicht. Überprüfen Sie die tatsächliche Pixelgröße des PNG: Frames werden falsch benannt (ein „120x600" mit 160 Breite exportiert, ein „970x90" mit 960 gezeichnet). Bauen Sie in der Google-Größe, platzieren Sie eventuelle zusätzliche Pixel an einer neutralen Stelle (einem soliden Panel) und sagen Sie es.
  • Wenn eine Größe keinen Frame hat, leiten Sie ihn von der nächstgelegenen genehmigten Größe derselben Familie ab (siehe references/spec-format.md für Familienmuster), teilen Sie dem Benutzer mit, dass es Ihre Anpassung ist, und bieten Sie an, anzupassen.
  • Benutzer senden oft Frames pro Szene (Frame 1, 2, 3). Behandeln Sie sie als die szenenweise Wahrheit für Fotos, Ausschnitte und jedes Element, das sich bewegt (z. B. ein Logo, das tiefer sitzt, wenn der Tagline erscheint).
  • Umgekehrte Figma-Ebenen melden verwirrende x-Positionen. Messen Sie stattdessen vom Screenshot oder Export.

4. Assets vorbereiten

  • Bilder mit 2x der CSS-Größe (Fotos als JPG, Qualität 60-78), Artwork als Palette-PNGs (quantize, 16-64 Farben). Logos mit 3x (darauf schauen die Leute; layers.py logo erledigt das).
  • Produkte, die einen zweifarbigen Hintergrund überspannen: Flachen Sie jede Szene auf den eigenen Hintergrund der Anzeige vollbreit mit einer ganzzahligen Pixel-Trennzeile, damit keine sichtbare Naht entsteht, wo eine Bildkante auf CSS trifft.
  • Halten Sie jedes ZIP bei oder unter 150.000 Bytes; reduzieren Sie die JPG-Qualität oder verkleinern Sie große Fotos bei Bedarf auf 1,5x.

5. Build

Schreiben Sie eine JSON-Spezifikation pro Größe (references/spec-format.md), dann:

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

Es schreibt build/300x250/index.html plus Assets und build/<prefix>_300x250.zip (Dateien im ZIP-Wurzelverzeichnis), und gibt Bytes und Dateianzahl aus. Die Vorlage enthält bereits: <meta name="ad.size">, var clickTag im head, einen gesamtanzeigen-Exit window.open(window.clickTag), die gemeinsame Motion-Timeline, einen 1px-Rahmen, Unterstützung für reduzierte Bewegung und einen #end-URL-Hook, der zum Endframe springt.

Die Bewegung (halten Sie sie innerhalb eines Satzes identisch, sofern nicht anders gewünscht): Headline ein (0,2 s), Angebot erscheint (0,9 s), Szene 2 (2,4 s), Szene 3 mit Headline-zu-Tagline-Wechsel (4,8 bis 5,1 s), Endkarte schiebt sich mit Angebot, Logo und CTA (7,6 bis 8,7 s) hoch, CTA glänzt; spielt zweimal, bleibt dann bei etwa 21 s auf der Endkarte stehen (unter Googles 30 s).

6. Qualitätssicherung (jede Größe, jedes Mal)

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

Es prüft den ad.size-Meta-Tag, die clickTag-Deklaration und den Exit, die CSS-Klammerbalance, Seiten- und Konsolenfehler, externe Anfragen, defekte Bilder, Elemente, die außerhalb der Anzeige liegen, die Endkarte, den CTA-Text-Clipping, das Öffnen der clickTag-URL durch den Klick, den Ruhezustand nach zwei Durchläufen, das ZIP-Wurzelverzeichnis, Bytes und Dateianzahl. Korrigieren und wiederholen, bis alles bestanden ist. Sehen Sie sich dann das Ergebnis an: Rendern Sie jeden Szenenzustand (Klassen still s1 s2, still s1 s2 c2, still s1 s2 c2 c3 s3 und das Ende) und vergleichen Sie es nebeneinander mit den Referenzframes. Ein Pixeldiff pro Bereich (linke Zone, Foto, Angebot) zeigt schnell, was falsch ist.

7. Vorschau

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

Dies schreibt ein MP4 in Originalgeschwindigkeit und ein GIF (es timet die Aufnahme mit einer On-Page-Uhr neu). Überprüfen Sie vier Frames (ca. 1,5, 3,4, 6,0 und 9,5 s) vor der Präsentation: Headline und Angebot, Szene 2, Tagline, Endkarte.

8. Lieferung

  • Prüfen Sie zuerst die Abdeckung: Vergleichen Sie die gelieferten ZIP-Namen mit der angeforderten Grössenliste und bauen Sie alles, was fehlt, bevor Sie antworten (eine 250x250 fehlte einmal mehrere Runden lang). Führen Sie die QA nach jeder Änderung an einem gemeinsamen Asset (Logo, Angebot, Vorlage) erneut für den gesamten Satz durch.
  • Ein ZIP pro Größe, benannt <Marke>_<Kampagne>_<BxH>.zip, kopiert nach /mnt/user-data/outputs/ und präsentiert mit dem Vorschaugif zuerst. Wenn Sie ein ZIP neu erstellen, bestätigen Sie, dass sich der Inhalt der gelieferten Datei geändert hat (cmp eine Datei darin), da Zeitstempel veraltet aussehen können.
  • Für einen vollständigen Satz liefern Sie auch ein Paket mit allen Größen (README, ein Übersichtsbild jeder Größe und die ZIPs).
  • In der Antwort: was in jeder Datei ist, die Bewegung in einer kurzen Sequenz, Größen in KB, welche Layouts den Figma-Frames folgen und welche Ihre Anpassung sind, sowie etwaige Kompromisse (weiche Quelle, geänderte CTA-Formulierung, 960 zu 970).
  • Erstbenutzer: Erklären Sie, dass sich die HTML-Datei im ZIP befindet, dass sie das ZIP selbst hochladen und dass Entpacken und Doppelklicken auf index.html eine Vorschau zeigt (die Bilder müssen daneben bleiben).

Stolpersteine, die auf die harte Tour gelernt wurden

  • Klassennamen kollidieren mit Zustandsklassen. Die Timeline fügt c2/c3 zu #ad hinzu; vergeben Sie niemals diese Klassennamen an Elemente (eine Bildklasse .c2{opacity:0} hat einmal die gesamte Anzeige versteckt). Die Vorlage verwendet sc2/sc3.
  • Klammerfehler töten die Regeln danach. Eine versehentliche } hat die Endkarte stummgeschaltet. Der Builder und die QA überprüfen beide die Klammerbalance.
  • Videokodierungen verschieben Farben geringfügig; Figma ist exakt. Entnehmen Sie Markenfarben aus Figma (get_design_context auf einer einfarbigen Ebene) oder dem Marken-Skill, nicht aus Videopixeln. Weisen Sie auf Konflikte zwischen den Rottönen der Kreation und dem Markenstandard hin, anstatt sie stillschweigend zu „korrigieren".
  • Headless-Aufzeichnung läuft 10-35 % langsam und ungleichmäßig. Vertrauen Sie niemals auf das rohe Timing einer Aufnahme; verwenden Sie record_preview.py.
  • Text bei 50 px Höhe. „Vereinbaren Sie eine kostenlose Beratung" passt nicht auf eine 300x50-Endkarte; verwenden Sie dort einen kurzen CTA („Jetzt buchen") und lassen Sie die vollständige Formulierung dort, wo sie passt. Sagen Sie es dem Benutzer.
  • Google zählt 150 KB. Bleiben Sie bei oder unter 150.000 Bytes, damit beide Auslegungen des Limits bestehen.
  • CTA-Textüberfüllung. Ein Label, das etwas breiter ist als der Platz innerhalb des Innenabstands, bleibt sichtbar, sitzt aber außermittig. qa_ads.py warnt davor; reduzieren Sie den Button-Innenabstand (14 auf 10 px) oder die Schriftgröße.
  • Änderungen an gemeinsamen Assets betreffen jedes ZIP. Wenn ein Logo oder eine Logokombination ersetzt wird, bauen Sie jede Größe neu, führen Sie die QA erneut durch, ersetzen oder löschen Sie veraltete Bündel (z. B. ein altes ZIP aller Größen) und bestätigen Sie, dass sich jede gelieferte Datei geändert hat.
  • Fragen Sie einmal, präzise. Wenn Sie Dateien benötigen, listen Sie die genauen Ebenen, Frames und den Exportmaßstab in einer Tabelle auf, plus die Alternative (ein Organisationsinhaber kann www.figma.com auf die Whitelist setzen). Fragen Sie nicht noch einmal nach etwas, das bereits beantwortet wurde.

Verwandte Skills