Skip to content

Hainrixz/claude-ads / ads

Free-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.

FileKindSize
SKILL.mdskill md18.6 KB
references/additional-platforms.mdmarkdown3.6 KB
references/audit-history-schema.jsonconfig2.5 KB
references/audit-methodology.mdmarkdown4.3 KB
references/audit-output-schema.jsonconfig4.9 KB
references/benchmarks-cross.mdmarkdown1003 B
references/benchmarks-google.mdmarkdown1.6 KB
references/benchmarks-social.mdmarkdown2.6 KB
references/benchmarks.mdmarkdown929 B
references/bidding-google.mdmarkdown5.2 KB
references/bidding-meta.mdmarkdown1.8 KB
references/bidding-strategies.mdmarkdown989 B
references/bidding-tiktok.mdmarkdown2.0 KB
references/brand-dna-template.mdmarkdown6.9 KB
references/budget-allocation.mdmarkdown5.8 KB
references/compliance-changes-2025-2026.mdmarkdown2.5 KB
references/compliance-platforms.mdmarkdown3.6 KB
references/compliance-privacy.mdmarkdown3.1 KB
references/compliance.mdmarkdown1.6 KB
references/conciencia-schema.jsonconfig5.3 KB
references/conciencia.mdmarkdown5.2 KB
references/conversion-tracking.mdmarkdown1.2 KB
references/copy-frameworks.mdmarkdown8.9 KB
references/gaql-notes.mdmarkdown2.8 KB
references/google-audit-notes.mdmarkdown3.9 KB
references/google-audit.mdmarkdown12.5 KB
references/google-changelog-30d.mdmarkdown3.6 KB
references/google-creative-specs.mdmarkdown3.7 KB
references/image-providers.mdmarkdown4.9 KB
references/mcp-integration.mdmarkdown5.7 KB
references/mcp-meta-integration.mdmarkdown5.8 KB
references/meta-audit.mdmarkdown12.4 KB
references/meta-changelog-30d.mdmarkdown4.0 KB
references/meta-creative-specs.mdmarkdown4.5 KB
references/platform-specs-cross.mdmarkdown1.3 KB
references/platform-specs.mdmarkdown799 B
references/profile-schema.jsonconfig4.5 KB
references/scoring-system.mdmarkdown6.1 KB
references/setup-google.mdmarkdown7.1 KB
references/setup-meta-developers.mdmarkdown4.7 KB
references/setup-meta.mdmarkdown7.0 KB
references/setup-tiktok.mdmarkdown5.2 KB
references/setup-zernio.mdmarkdown4.5 KB
references/tiktok-audit.mdmarkdown10.1 KB
references/tiktok-changelog-30d.mdmarkdown3.5 KB
references/tiktok-creative-specs.mdmarkdown4.8 KB
references/tracking-cross.mdmarkdown1.5 KB
references/tracking-google.mdmarkdown2.8 KB
references/tracking-meta.mdmarkdown2.4 KB
references/tracking-tiktok.mdmarkdown1.5 KB
references/update-cost-warning.mdmarkdown2.0 KB
references/voice-to-style.mdmarkdown3.9 KB
research-sources/README.mdmarkdown883 B
research-sources/claude-research.mdmarkdown3.9 KB
research-sources/gemini-research.mdmarkdown10.2 KB
research-sources/google-audit-checklists.mdmarkdown25.9 KB
research-sources/google-optimization-logic.mdmarkdown11.9 KB
research-sources/google-platform-specs.mdmarkdown16.6 KB

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.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall