Static Ad & Graphic Design Agent (static-ad-design-agent)
In: Brand kit (MASTER_CONTEXT.md, website URL, palette, fonts, logo, or product screenshots) + offer/angle
Out: Finished Instagram Carousels, Static Image Ads (Feed, Portrait, Story, Landscape), Banners, Thumbnails, Deterministic Visual & Copy QA (_qa/qa-report.json), and an Interactive Visual Review Board (review/index.html).
This skill is the static-creative sister pack to mrpaidsocial-video-editor-agent. It follows the same culture: verify pixels, safe zones, and claim compliance — not intentions.
The Pipeline at a Glance
(0) Intake & Brand Tokens (MASTER_CONTEXT.md + offer/angle)
│
▼
(1) Angle & Archetype Plan ──→ ads-manifest.json (variants, carousels, copy, UTMs)
│
▼
(2) Composition Build ───────→ HTML/CSS or Pillow/SVG artboards from ad-canvas-starter.html
│
▼
(3) Rasterize to PNG ────────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
│
▼
(4) Deterministic QA Loop ───→ python3 scripts/qa_static_ads.py (pixels, safe zones, banned claims)
│
▼
(5) Interactive Review Board → python3 scripts/build_ad_review_board.py → review/index.html
Stage 0 — Intake & Brand Tokens
- Check for
MASTER_CONTEXT.mdin the current workspace root (or copy fromMASTER_CONTEXT.template.md). - Extract:
- Brand tokens:
--bg-ink,--bg-paper,--accent-primary,--accent-secondary,--accent-alert, heading/body fonts, logo, and real product screenshots. - Guardrails:
banned_phrasesand canonical vocabulary rules.
- Brand tokens:
- Confirm or default the deliverable pack:
- Carousel Pack: 5–7 slides at
1080×1350(4:5vertical feed max real estate). - Static Ad Trio:
1080×1350(4:5Feed),1080×1080(1:1Square),1080×1920(9:16Story/Reel placement). - Banner / Thumbnail:
1200×628(Link/Display Ad) or1920×1080(Video Thumbnail).
- Carousel Pack: 5–7 slides at
- Create the campaign working folder:
outputs/<campaign-slug>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
Stage 1 — Angle & Archetype Plan (ads-manifest.json)
Read references/archetypes-and-safe-zones.md before laying out cards. Pick from the 10 proven static & carousel archetypes:
- Wrong-Stamp Myth Buster (Screenshot/claim with crisp
WRONGorMYTHstamp → truth card) - Us vs. Them Split Comparison (2-column contrast table: Old Way vs. Brand Way)
- Annotated Product UI Proof (Real product screenshot or card with 3 zoomed callout pills)
- Cost / Time Count-Up Stack (Stacked receipt of hidden costs/hours vs. 1 clean solution)
- 3-Step Mechanism Diagram (Input → Engine → Outcome with numbered badges)
- Stat Hero + Cited Source (Massive metric callout + verbatim citation strip at bottom)
- Checklist Gate Card ("Do not apply/launch until you check these 4 boxes")
- Before / After State Card (Overwhelmed/scattered state → structured roadmap state)
- 5–7 Slide Narrative Carousel (Slide 1 Hook → Slide 2 Agitate/Data → Slides 3–5 Actionable Value + Product Proof → Slide 6 Summary Checklist → Slide 7 CTA)
- High-Contrast Thumbnail / Banner (3–5 word punch phrase + focal subject/UI + contrast badge)
Write outputs/<campaign-slug>/ads-manifest.json adhering to the schema checked by scripts/qa_static_ads.py:
{
"campaign_slug": "sa-bursary-deadlines-q4",
"brand_name": "Gradwyn",
"offer_angle": "Don't miss SA engineering & CS bursary deadlines because requirements are buried across 40 PDFs.",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"guaranteed admission",
"guaranteed scholarship",
"chance of getting in",
"admission probability"
],
"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": "Most students miss scholarships not because of grades—but because they discover them 2 weeks after the deadline closed.",
"headline": "See scholarships matched to your Student Profile",
"cta_label": "Learn More",
"slides": [
{
"slide_index": 1,
"file": "renders/carousel-01-slide-01.png",
"eyebrow": "2027 INTAKE · SOUTH AFRICA & GLOBAL",
"headline": "3 Reasons Ambitious Students Miss Funding Every Year",
"subhead": "And how to build a deadline-tracked Roadmap in 4 minutes →",
"footer_note": "Swipe for the checklist (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": "UNIVERSITY & SCHOLARSHIP GUIDANCE",
"headline": "Stop Guessing From 40 Open Browser Tabs.",
"subhead": "Get 3 university Matches with a transparent Fit Score and step-by-step Roadmap.",
"primary_text": "Gradwyn matches students to universities and scholarships using AI—with clear reasons and official sources.",
"cta_label": "Get Your 3 Matches"
}
]
}
Stage 2 & 3 — Build Artboards & Rasterize to PNG
- Start from resources/ad-canvas-starter.html or use the built-in renderer inside scripts/qa_static_ads.py (
--render-from-manifest) which can render crisp, publication-grade1080×1350,1080×1080,1080×1920,1200×628, and1920×1080PNG artboards directly fromads-manifest.jsonusing Pillow + TrueType fonts (NotoSerif/NotoSans) when headless browser rendering is unavailable. - Respect platform safe zones defined in references/archetypes-and-safe-zones.md:
9:16(1080×1920) Story/Reel Ad: Keep all text and logos insidey: 250px .. 1520pxandx: 72px .. 1008px.4:5(1080×1350) Feed / Carousel: Keep all text inside72pxouter padding (936×1206safe box) and keep slide-indicator badges out of the top-right140×100pxcorner where Instagram overlays the1/5counter.1:1(1080×1080) Square:64pxouter padding.
Stage 4 — Deterministic Visual & Copy QA
Run the QA engine on the campaign folder:
python3 scripts/qa_static_ads.py --manifest outputs/<campaign-slug>/ads-manifest.json --render-missing
What qa_static_ads.py verifies on every asset:
- File & Pixel Integrity: Every referenced PNG exists, is non-corrupt, and matches its exact declared pixel width and height (
1080×1350,1080×1080,1080×1920,1200×628,1920×1080). - Visual Variance & Edge Margin Check: Confirms the image is not blank/flat and checks safe-zone edges for accidental text clipping.
- Copy Density & Hierarchy: Enforces headline word/character caps (
<= 12 wordson-canvas headline for instant mobile scan), primary text completeness, and CTA presence. - Guardrail & Banned-Claim Gate: Scans every headline, subhead, slide body, and primary caption against
banned_phrasesfromMASTER_CONTEXT.md. Any violation fails QA with an exact line report. - Visual Inspection: After
qa_static_ads.pypasses, inspect the rendered PNGs visually to confirm hierarchy, contrast, and alignment.
Stage 5 — Interactive Visual Review Board
Generate the human review canvas:
python3 scripts/build_ad_review_board.py --manifest outputs/<campaign-slug>/ads-manifest.json
This writes outputs/<campaign-slug>/review/index.html featuring:
- Horizontal swipe/scroll preview of every Instagram Carousel slide strip in order.
- Full grid of Static Image Ads, Story Ads, Banners, and Thumbnails.
- Interactive Safe-Zone Overlay Toggle (shows Meta/IG/TikTok UI dead zones directly over the graphics).
- Per-Asset QA Badge (Pass / Warning / Fail from
_qa/qa-report.json). - One-Click Copy for Primary Text, Headline, and UTM-tagged CTA URLs.
- Approve / Flag for Revision toggles with JSON revision-notes export.