Hainrixz/claude-ads / ads
ads
UnverifiedFree-first paid advertising audit and optimization skill, focused on the 3 platforms where 95% of advertiser spend lives: Meta, Google, TikTok. Guided onboarding (/ads start) saves context once and step-by-step OAuth walkthroughs; continuous coach (/ads next) ranks Quick Wins after each audit. ~158 weighted checks with scoring, parallel agents, industry templates, and AI creative generation.
references/google-creative-specs.md
View on GitHub# Google Creative Specs: Generation Guide
<!-- Updated: 2026-03-12 -->
<!-- Source: platform-specs.md + Google Ads asset requirements -->
<!-- Used by: ads-generate, visual-designer agent -->
## Purpose
Generation-ready specifications for Google Ads creative assets. Use these when
constructing image prompts for PMax asset groups, RSA companion images, Demand Gen,
and YouTube thumbnails.
---
## Performance Max Asset Group
### Image Assets (required for full coverage)
| Asset Type | Dimensions | Ratio | Priority |
|-----------|-----------|-------|----------|
| Marketing image (landscape) | 1200×628 | 1.91:1 | **Required** |
| Square image | 1200×1200 | 1:1 | **Required** |
| Portrait image | 960×1200 | 4:5 | High |
| Logo (landscape) | 1200×300 | 4:1 | Required |
| Logo (square) | 1200×1200 | 1:1 | Required |
**Max per asset group:** 20 images total across marketing + square + portrait.
**File requirements:** JPG or PNG, max 5MB, min 128×128.
### Generation targets per campaign
Minimum viable set (3 images):
1. `1200×628` landscape: primary ad creative
2. `1200×1200` square: feed placements
3. `960×1200` portrait: mobile-optimized
Full coverage set (5 images): add `1080×1920` vertical for YouTube Shorts placements.
---
## Demand Gen (formerly Discovery)
| Placement | Ratio | Recommended Size |
|-----------|-------|-----------------|
| Google Discover | 1:1 | 1080×1080 |
| Google Discover | 4:5 | 1080×1350 |
| Gmail Promotions | 1.91:1 | 1200×628 |
| YouTube In-Feed | 1:1 | 1080×1080 |
Generate both 1:1 and 4:5 variants for maximum placement coverage.
---
## YouTube Thumbnails
| Type | Dimensions | Notes |
|------|-----------|-------|
| Standard thumbnail | 1280×720 (16:9) | Used for in-feed, search results |
| Square thumbnail | 1080×1080 (1:1) | Shorts feed |
**Thumbnail generation guidelines:**
- High contrast between subject and background
- Face or product in center-left position (text overlays go right)
- Avoid busy backgrounds; viewer scans at thumbnail size
- Bright, saturated colors outperform muted palettes for CTR
- Include product or person; abstract imagery underperforms
---
## RSA Copy Limits (for copy-writer agent)
| Component | Min | Max | Character Limit |
|-----------|-----|-----|-----------------|
| Headlines | 3 | 15 | 30 chars each |
| Descriptions | 2 | 4 | 90 chars each |
| Display paths | N/A | 2 | 15 chars each |
Best practice: 8+ headlines, 2+ descriptions.
---
## Image Generation Prompt Modifiers
Apply these modifiers to every Google ad image prompt:
**Always include:**
- `"horizontal composition"` (for 1.91:1 and 16:9 assets)
- `"clean background"` (PMax images compete for attention in content feeds)
- `"product or subject centered with breathing room"`
- `"no text overlay"` (text is applied by the ad platform, not baked into the image)
- `"high contrast, vibrant colors"`
**Avoid in prompts:**
- Extreme close-ups (PMax crops images across many placements)
- Complex scene layouts (will crop poorly to 1:1 and 4:5)
- Text or logos embedded in the image (violates Google policy for some ad types)
---
## AI Max for Search (2026)
AI Max is Google's broad match + AI-generated creative system. When active:
- Headlines may be auto-generated from landing page content
- URL expansion sends traffic to best-fit page (not just Final URL)
- Image generation for PMax applies AI selection from asset pool
**Implication for generation:** Provide diverse asset pool (3+ aspect ratios,
3+ visual angles) to give AI Max more to work with.
---
## Aspect Ratio Priority
When generating a single image for Google (time-constrained):
1. `1200×628` (1.91:1): covers most placements
2. `1200×1200` (1:1): adds feed placements
3. `960×1200` (4:5): adds mobile portrait placements
Always generate 1 and 2 at minimum.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |