Comprehensive paid advertising audit and optimization skill for Antigravity. Covers Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, and Apple Ads with 250+ audit checks, industry-specific templates, parallel subagent delegation, PPC financial modeling, A/B test design, and PDF report generation.
This is a fork of the original claude-ads repository, heavily modified and re-architected to run natively as an Antigravity skill using natural language triggers rather than CLI slash commands.
irm https://raw.githubusercontent.com/kutzki/antigravity-ads/main/install.ps1 | iexcurl -fsSL https://raw.githubusercontent.com/kutzki/antigravity-ads/main/install.sh | bashgit clone https://github.com/kutzki/antigravity-ads.git
cd antigravity-ads
./install.sh # Unix/macOS/Linux
# OR
.\install.ps1 # Windows PowerShell
Because this skill is deeply integrated into Antigravity, you no longer need to memorize specific slash commands. Simply tell Antigravity what you want to achieve.
Here is how the original claude-ads CLI commands translate into natural language prompts:
| Capability | Example Prompt |
|---|---|
| Full Cross-Platform Audit | "Run a full multi-platform ads audit. I'm an e-commerce brand spending /mo. Here is my data..." |
| Google Ads Deep Dive | "Audit my Google Ads account. Review my PMax setup and Search broad match keywords." |
| Meta Ads Deep Dive | "Run a Meta Ads analysis. Check if my Advantage+ shopping campaigns are overlapping." |
| TikTok Ads Deep Dive | "Audit my TikTok Ads. Am I hitting the creative diversity and budget sufficiency minimums?" |
| LinkedIn Ads Deep Dive | "Review my LinkedIn B2B campaigns. Are my Lead Gen forms optimized?" |
| YouTube Ads Deep Dive | "Analyze my YouTube Ads performance, specifically my Shorts placements." |
| Microsoft/Apple Ads | "Audit my Apple Search Ads structure and CPPs." |
| Amazon Ads | "Audit my Amazon PPC campaigns. Should I be running Sponsored Brands?" |
| Creative Quality Audit | "Run a cross-platform creative audit on the attached ad images. Do they meet Meta's safe zones?" |
| Landing Page Audit | "Review this landing page [url]. Is it optimized for cold ad traffic?" |
| Budget & Bidding Review | "Review my budget allocation. Should I be using Target CPA or Maximize Conversions here?" |
| Campaign Planning | "Create a strategic ad plan for a B2B Enterprise software company." |
| Competitor Intelligence | "Run a competitor ad analysis against [competitor URL]." |
| PPC Math & Calculators | "Calculate my break-even ROAS and target CPA based on a LTV and 40% margin." |
| A/B Test Design | "Design an A/B test for my new ad copy. How long does it need to run for statistical significance?" |
| PDF Report Generation | "Generate a professional PDF audit report of everything we just discussed for my client." |
| Creative Generation | "Extract the brand DNA from [url], create 3 campaign concepts, and generate the ad images." |
The orchestrator will automatically collect missing context, select the appropriate sub-module, and execute the task!
Comprehensive coverage across all platforms with weighted severity scoring:
| Platform | Checks | Key Areas |
|---|---|---|
| Google Ads | 80 | Search, PMax, AI Max, Demand Gen, CTV, YouTube |
| Meta Ads | 50 | Pixel/CAPI, Andromeda creative diversity, Structure, Audience |
| LinkedIn Ads | 27 | B2B targeting, TLA, Lead Gen, CRM integration |
| TikTok Ads | 28 | Creative-first, Smart+, GMV Max, Search Ads, Events API |
| Microsoft Ads | 24 | Google import safety, Copilot, CTV, LinkedIn targeting, video |
| Apple Ads | 35+ | Campaign structure, CPPs, Maximize Conversions, AdAttributionKit |
| Amazon Ads | 15+ | ACOS vs TACOS, KDP Backend Keywords, Attribution, Bridge Pages |
| Cross-platform | 3 | Privacy infrastructure, creative diversity, refresh cadence |
Hard rules enforced during every audit:
- Never recommend Broad Match without Smart Bidding (Google)
- 3x Kill Rule: flag CPA >3x target for immediate pause
- Budget sufficiency: Meta >=5x CPA/ad set, TikTok >=50x CPA/ad group
- Learning phase protection: no edits during active learning
- Compliance: auto-check Special Ad Categories (housing/credit/finance)
AI-powered creative generation with specialized agents that extract brand DNA, create campaign concepts, write copy, and generate imagery using your configured image_provider (Gemini by default).
The system has been restructured for Antigravity's unified skill loading:
~/.gemini/antigravity/skills/antigravity-ads/
├── SKILL.md # Main orchestrator (Natural Language Router)
├── modules/ # 17 sub-skills (Google, Meta, Creative, etc.)
├── references/ # 25 RAG reference files
├── agents/ # 10 agents (6 audit + 4 creative)
└── scripts/ # Python tools (PDF generation, landing page parsing)
Antigravity Ads works with data you provide; exports, screenshots, or pasted metrics from your ad platform dashboards. It does not connect to any ad platform API automatically unless paired with an MCP server like mcp-google-ads.
To get accurate, account-specific recommendations:
- Export your account data (last 30 days recommended)
- Ask Antigravity to run an audit.
- Antigravity will ask for your industry and budget context first; provide these for relevant benchmarks
- Paste or share your data when prompted.
- Antigravity
- Python 3.10+ (for
playwrightandreportlabtools)
MIT License - see LICENSE for details.
Forked and customized for Antigravity based on the original claude-ads project by Agrici Daniel.