Static Ad & Graphic Design Agent (static-ad-design-agent)
Eingabe: Brand Kit (MASTER_CONTEXT.md, Website-URL, Palette, Schriftarten, Logo oder Produktscreenshots) + Angebot/Perspektive
Ausgabe: Fertige Instagram Karussells, Statische Bildanzeigen (Feed, Portrait, Story, Landscape), Banner, Thumbnails, Deterministische visuelle & textliche Qualitätssicherung (_qa/qa-report.json) und ein Interaktives visuelles Review-Board (review/index.html).
Dieses Skill ist die Static-Creative-Schwestererweiterung zu mrpaidsocial-video-editor-agent. Es folgt derselben Kultur: Pixel, Sicherheitszonen und Claim-Compliance verifizieren – nicht Absichten.
Die Pipeline auf einen Blick
(0) Aufnahme & Brand-Tokens (MASTER_CONTEXT.md + Angebot/Perspektive)
│
▼
(1) Perspektiven- & Archetypen-Plan ──→ ads-manifest.json (Varianten, Karussells, Texte, UTMs)
│
▼
(2) Kompositionserstellung ───────→ HTML/CSS oder Pillow/SVG-Arbeitsflächen basierend auf ad-canvas-starter.html
│
▼
(3) Rasterisierung zu PNG ────────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
│
▼
(4) Deterministische QA-Schleife ───→ python3 scripts/qa_static_ads.py (Pixel, Sicherheitszonen, verbotene Behauptungen)
│
▼
(5) Interaktives Review-Board → python3 scripts/build_ad_review_board.py → review/index.html
Stufe 0 — Aufnahme & Brand-Tokens
- Prüfe auf
MASTER_CONTEXT.mdim aktuellen Workspace-Root (oder kopiere vonMASTER_CONTEXT.template.md). - Extrahiere:
- Brand-Tokens:
--bg-ink,--bg-paper,--accent-primary,--accent-secondary,--accent-alert, Überschrift-/Textschriften, Logo und echte Produktscreenshots. - Guardrails:
banned_phrasesund kanonische Vokabularregeln.
- Brand-Tokens:
- Bestätige oder setze das Standard-Lieferpaket:
- Karussell-Paket: 5–7 Folien bei
1080×1350(4:5maximale vertikale Feed-Fläche). - Static-Ad-Trio:
1080×1350(4:5Feed),1080×1080(1:1Quadratisch),1080×1920(9:16Story/Reel-Platzierung). - Banner / Thumbnail:
1200×628(Link/Display-Anzeige) oder1920×1080(Video-Thumbnail).
- Karussell-Paket: 5–7 Folien bei
- Erstelle den Kampagnen-Arbeitsordner:
outputs/<kampagnen-slug>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
Stufe 1 — Perspektiven- & Archetypen-Plan (ads-manifest.json)
Lies references/archetypes-and-safe-zones.md bevor Karten angelegt werden. Wähle aus den 10 bewährten Static- & Karussell-Archetypen:
- Wrong-Stamp Myth Buster (Screenshot/Claim mit prägnantem
WRONGoderMYTH-Stempel → Wahrheitskarte) - Us vs. Them Split Comparison (2-spaltige Kontrasttabelle: Alter Weg vs. Markenweg)
- Annotated Product UI Proof (Echter Produktscreenshot oder Karte mit 3 vergrößerten Callout-Pillen)
- Cost / Time Count-Up Stack (Gestapelte Quittung der versteckten Kosten/Stunden vs. 1 saubere Lösung)
- 3-Step Mechanism Diagram (Eingabe → Engine → Ergebnis mit nummerierten Badges)
- Stat Hero + Cited Source (Massiver Metrik-Callout + wörtliches Zitat am unteren Rand)
- Checklist Gate Card („Nicht bewerben/starten, bis diese 4 Punkte geprüft sind“)
- Before / After State Card (Überforderter/unstrukturierter Zustand → strukturierter Roadmap-Zustand)
- 5–7 Slide Narrative Carousel (Folie 1 Hook → Folie 2 Agitation/Daten → Folien 3–5 Handlungsorientierter Wert + Produktnachweis → Folie 6 Zusammenfassungs-Checkliste → Folie 7 CTA)
- High-Contrast Thumbnail / Banner (3–5-Wort-Punch-Phrase + Fokusmotiv/UI + Kontrast-Badge)
Schreibe outputs/<kampagnen-slug>/ads-manifest.json unter Einhaltung des Schemas, das von scripts/qa_static_ads.py geprüft wird:
{
"campaign_slug": "sa-bursary-deadlines-q4",
"brand_name": "Gradwyn",
"offer_angle": "Verpassen Sie nicht die SA-Wirtschafts- & Informatik-Stipendienfristen, weil die Anforderungen über 40 PDFs verteilt sind.",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"garantierte Zulassung",
"garantiertes Stipendium",
"Wahrscheinlichkeit der Aufnahme",
"Zulassungswahrscheinlichkeit"
],
"brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
"creatives": [
{
"id": "carousel-01",
"type": "carousel",
"archetype": "5-slide-narrative-carousel",
"format": "4:5",
"width": 1080,
"height": 1350,
"primary_text": "Die meisten Studierenden verpassen Stipendien nicht wegen Noten – sondern weil sie sie erst 2 Wochen nach Fristablauf entdecken.",
"headline": „Sehen Sie Stipendien passend zu Ihrem Studentenprofil“,
„cta_label“: „Mehr erfahren“,
„slides“: [
{
„slide_index“: 1,
„file“: „renders/carousel-01-slide-01.png“,
„eyebrow“: „2027-INTAKE · SÜDAFRIKA & GLOBAL“,
„headline“: „3 Gründe, warum ambitionierte Studierende jedes Jahr Finanzierungen verpassen“,
„subhead“: „Und wie Sie in 4 Minuten einen fristenverfolgten Fahrplan erstellen →“,
„footer_note“: „Wischen Sie für die Checkliste (1/5)“
}
]
},
{
„id“: „static-feed-01“,
„type“: „static_ad“,
„archetype“: „us-vs-them-split“,
„format“: „4:5“,
„width“: 1080,
„height“: 1350,
„file“: „renders/static-feed-01.png“,
„eyebrow“: „UNIVERSITÄTS- & STIPENDIENBERATUNG“,
„headline“: „Hören Sie auf, aus 40 offenen Browser-Tabs zu raten.“,
„subhead“: „Erhalten Sie 3 Universitätsvorschläge mit transparentem Fit-Score und schrittweisem Fahrplan.“,
„primary_text“: „Gradwyn matcht Studierende mit Universitäten und Stipendien mittels KI – mit klaren Gründen und offiziellen Quellen.“,
„cta_label“: „Holen Sie sich Ihre 3 Vorschläge“
}
]
}
Stufe 2 & 3 — Arbeitsflächen erstellen & zu PNG rastern
- Starte von resources/ad-canvas-starter.html oder verwende den integrierten Renderer in scripts/qa_static_ads.py (
--render-from-manifest), der gestochen scharfe, publikationsreife1080×1350,1080×1080,1080×1920,1200×628und1920×1080PNG-Arbeitsflächen direkt ausads-manifest.jsonmit Pillow + TrueType-Schriftarten (NotoSerif/NotoSans) rendern kann, wenn Headless-Browser-Rendering nicht verfügbar ist. - Beachte die plattformspezifischen Sicherheitszonen, die in references/archetypes-and-safe-zones.md definiert sind:
9:16(1080×1920) Story/Reel-Anzeige: Halte Text und Logos innerhalb vony: 250px .. 1520pxundx: 72px .. 1008px.4:5(1080×1350) Feed / Karussell: Halte Text innerhalb des äußeren72px-Rands (936×1206Sicherheitsbereich) und platziere Folienindikator-Badges außerhalb der oberen rechten140×100pxEcke, wo Instagram den1/5-Zähler überlagert.1:1(1080×1080) Quadrat:64pxäußerer Rand.
Stufe 4 — Deterministische visuelle & textliche Qualitätssicherung
Führe die QA-Engine auf dem Kampagnenordner aus:
python3 scripts/qa_static_ads.py --manifest outputs/<kampagnen-slug>/ads-manifest.json --render-missing
Was qa_static_ads.py bei jedem Asset überprüft:
- Datei- & Pixelintegrität: Jedes referenzierte PNG existiert, ist nicht beschädigt und stimmt exakt mit der deklarierten Pixelbreite und -höhe überein (
1080×1350,1080×1080,1080×1920,1200×628,1920×1080). - Visuelle Varianz & Randprüfung: Stellt sicher, dass das Bild nicht leer/einfarbig ist, und prüft die Sicherheitszonen auf versehentliches Abschneiden von Text.
- Textdichte & Hierarchie: Setzt Ober-/Untergrenzen für Überschrift-Wörter/Zeichen (
<= 12 Wörterauf der Leinwand für sofortiges mobiles Erfassen), Vollständigkeit des Haupttextes und Vorhandensein des CTA. - Guardrail- & Verbotener-Claim-Check: Scannt jede Überschrift, Zwischenüberschrift, Folientext und Hauptbeschriftung gegen
banned_phrasesausMASTER_CONTEXT.md. Jeder Verstoß führt zu einem QA-Fehler mit exaktem Zeilenbericht. - Visuelle Inspektion: Nach bestandener
qa_static_ads.py-Prüfung die gerenderten PNGs visuell inspizieren, um Hierarchie, Kontrast und Ausrichtung zu bestätigen.
Stufe 5 — Interaktives visuelles Review-Board
Generiere die menschliche Review-Leinwand:
python3 scripts/build_ad_review_board.py --manifest outputs/<kampagnen-slug>/ads-manifest.json
Dies schreibt outputs/<kampagnen-slug>/review/index.html mit:
- Horizontaler Swipe/Scroll-Vorschau jedes Instagram Karussells als Folienstreifen in der richtigen Reihenfolge.
- Vollständigem Raster der Statischen Bildanzeigen, Story-Anzeigen, Banner und Thumbnails.
- Interaktivem Sicherheitszonen-Overlay-Toggle (zeigt Meta/IG/TikTok UI-Totzonen direkt über den Grafiken).
- QA-Badge pro Asset (Bestanden / Warnung / Fehlgeschlagen aus
_qa/qa-report.json). - One-Click-Kopie für Haupttext, Überschrift und UTM-getaggte CTA-URLs.
- Genehmigen / Zur Überarbeitung markieren-Toggles mit JSON-Revisionsnotizen-Export.