CommunityImagegithub.com

static-ad-design-agent

Turn a brand kit (colors, fonts, logo, screenshots, or MASTER_CONTEXT.md) plus an offer or angle into finished Instagram carousels (1080x1350 / 1080x1080), static paid-social image ads (1080x1080, 1080x1350, 1080x1920, 1200x628), banners, and video thumbnails (1920x1080) — complete with deterministic visual & copy QA and an interactive HTML review board. Sister pack to mrpaidsocial-video-editor-agent. Use whenever the user asks to design static ads, Instagram/LinkedIn carousels, paid social creative packs, ad banners, or thumbnails from an offer or angle.

What is static-ad-design-agent?

static-ad-design-agent is a Claude Code agent skill that turn a brand kit (colors, fonts, logo, screenshots, or MASTER_CONTEXT.md) plus an offer or angle into finished Instagram carousels (1080x1350 / 1080x1080), static paid-social image ads (1080x1080, 1080x1350, 1080x1920, 1200x628), banners, and video thumbnails (1920x1080) — complete with deterministic visual & copy QA and an interactive HTML review board. Sister pack to mrpaidsocial-video-editor-agent. Use whenever the user asks to design static ads, Instagram/LinkedIn carousels, paid social creative packs, ad banners, or thumbnails from an offer or angle.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/uzowurumauritius-rgb/growth-ops-agent-skills/tree/HEAD/skills/static-ad-design-agent

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

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

  1. Check for MASTER_CONTEXT.md in the current workspace root (or copy from MASTER_CONTEXT.template.md).
  2. Extract:
    • Brand tokens: --bg-ink, --bg-paper, --accent-primary, --accent-secondary, --accent-alert, heading/body fonts, logo, and real product screenshots.
    • Guardrails: banned_phrases and canonical vocabulary rules.
  3. Confirm or default the deliverable pack:
    • Carousel Pack: 5–7 slides at 1080×1350 (4:5 vertical feed max real estate).
    • Static Ad Trio: 1080×1350 (4:5 Feed), 1080×1080 (1:1 Square), 1080×1920 (9:16 Story/Reel placement).
    • Banner / Thumbnail: 1200×628 (Link/Display Ad) or 1920×1080 (Video Thumbnail).
  4. 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:

  1. Wrong-Stamp Myth Buster (Screenshot/claim with crisp WRONG or MYTH stamp → truth card)
  2. Us vs. Them Split Comparison (2-column contrast table: Old Way vs. Brand Way)
  3. Annotated Product UI Proof (Real product screenshot or card with 3 zoomed callout pills)
  4. Cost / Time Count-Up Stack (Stacked receipt of hidden costs/hours vs. 1 clean solution)
  5. 3-Step Mechanism Diagram (Input → Engine → Outcome with numbered badges)
  6. Stat Hero + Cited Source (Massive metric callout + verbatim citation strip at bottom)
  7. Checklist Gate Card ("Do not apply/launch until you check these 4 boxes")
  8. Before / After State Card (Overwhelmed/scattered state → structured roadmap state)
  9. 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)
  10. 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

  1. 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-grade 1080×1350, 1080×1080, 1080×1920, 1200×628, and 1920×1080 PNG artboards directly from ads-manifest.json using Pillow + TrueType fonts (NotoSerif / NotoSans) when headless browser rendering is unavailable.
  2. Respect platform safe zones defined in references/archetypes-and-safe-zones.md:
    • 9:16 (1080×1920) Story/Reel Ad: Keep all text and logos inside y: 250px .. 1520px and x: 72px .. 1008px.
    • 4:5 (1080×1350) Feed / Carousel: Keep all text inside 72px outer padding (936×1206 safe box) and keep slide-indicator badges out of the top-right 140×100px corner where Instagram overlays the 1/5 counter.
    • 1:1 (1080×1080) Square: 64px outer 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 words on-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_phrases from MASTER_CONTEXT.md. Any violation fails QA with an exact line report.
  • Visual Inspection: After qa_static_ads.py passes, 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.

Related Skills