# Claude Ads: Paid Advertising Audit & Optimization Skill ## Project Overview This repository contains **Claude Ads**, a Tier 4 Claude Code skill for comprehensive paid advertising analysis across all major platforms. It follows the Agent Skills open standard and the 3-layer architecture (directive, orchestration, execution). 22 sub-skills, 11 agents (7 audit + 4 creative), and 12 industry templates cover Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, and Amazon Ads with 300+ weighted audit checks, plus cross-platform attribution, server-side tracking, and regulatory-compliance (EU AI Act + 22-state US privacy) deep dives. ## Architecture ``` claude-ads/ CLAUDE.md # Project instructions (this file) ads/ # Main orchestrator skill SKILL.md # Entry point, routing table, core rules references/ # On-demand knowledge files (25 files) scripts/ # Python execution scripts (repo root; installed under /ads/scripts/) skills/ # 22 specialized sub-skills (Wave 2) ads-audit/SKILL.md # Full multi-platform audit ads-google/SKILL.md # Google Ads deep analysis (incl. AI Max) ads-meta/SKILL.md # Meta/Facebook Ads (Andromeda + GEM + Lattice + Entity-ID predictor) ads-youtube/SKILL.md # YouTube Ads (Demand Gen, Shorts, CTV) ads-linkedin/SKILL.md # LinkedIn Ads analysis ads-tiktok/SKILL.md # TikTok Ads (post-USDS) ads-microsoft/SKILL.md # Microsoft/Bing Ads analysis ads-apple/SKILL.md # Apple Ads (AdAttributionKit, dual attribution) ads-amazon/SKILL.md # Amazon Ads (Sponsored Products/Brands/Display, ACOS/TACOS) ads-attribution/SKILL.md # Cross-platform attribution audit ads-server-side-tracking/SKILL.md # sGTM, CAPI Gateway, dedup, hashing ads-creative/SKILL.md # Creative quality + Entity-ID retrieval scoring ads-landing/SKILL.md # Landing page analysis ads-budget/SKILL.md # Budget allocation optimization ads-plan/SKILL.md # Strategic ad planning by industry ads-competitor/SKILL.md # Competitor ad research ads-math/SKILL.md # PPC financial calculator ads-test/SKILL.md # A/B test design ads-dna/SKILL.md # Brand DNA extraction ads-create/SKILL.md # Campaign concepts and copy briefs ads-generate/SKILL.md # AI ad image generation ads-photoshoot/SKILL.md # Product photography in 5 styles agents/ # 11 agents (7 audit + 4 creative) audit-google.md # Google Ads audit agent audit-meta.md # Meta Ads audit agent audit-creative.md # Creative quality agent audit-tracking.md # Conversion tracking agent audit-budget.md # Budget analysis agent audit-policy-compliance.md # Ad-policy + Special Ad Category + performance agent audit-regulatory-compliance.md # EU AI Act + US state privacy + DSA + MCP governance (v1.8.0) creative-strategist.md # Campaign concept strategist visual-designer.md # AI image generation orchestrator copy-writer.md # Headlines, CTAs, primary text format-adapter.md # Asset dimension validation tests/ # pytest eval harness (Wave 2) conftest.py # Shared fixtures fixtures/check-catalog.yaml # 300-check (5-platform) canonical catalog routing/ # Trigger → skill snapshot tests audit/ # Catalog coverage + scoring math tests scripts/ # SSRF + sanitize_error regression tests install.sh / install.ps1 # Cross-platform installers uninstall.sh / uninstall.ps1 # Cross-platform uninstallers ``` ## Commands | Command | Purpose | |---------|---------| | `/ads audit` | Full multi-platform audit with 7 parallel agents (Wave 2 sub-skills run standalone; see notes) | | `/ads google` | Google Ads deep analysis (incl. AI Max) | | `/ads meta` | Meta/Facebook Ads analysis (Andromeda + GEM + Lattice) | | `/ads youtube` | YouTube Ads analysis | | `/ads linkedin` | LinkedIn Ads analysis | | `/ads tiktok` | TikTok Ads analysis | | `/ads microsoft` | Microsoft/Bing Ads analysis | | `/ads apple` | Apple Ads (AdAttributionKit, dual attribution) | | `/ads amazon` | Amazon Ads (Sponsored Products/Brands/Display, ACOS/TACOS) — *Wave 2* | | `/ads attribution` | Cross-platform attribution audit (AAK, GA4, Consent Mode V2, MMP) — *Wave 2* | | `/ads tracking` | Server-side tracking pipeline audit (sGTM, CAPI Gateway, dedup, hashing) — *Wave 2* | | `/ads creative` | Creative quality and fatigue assessment | | `/ads landing` | Landing page conversion analysis | | `/ads budget` | Budget allocation optimization | | `/ads plan ` | Strategic ad planning by industry | | `/ads competitor` | Competitor ad research | | `/ads math` | PPC financial calculator (CPA, ROAS, break-even, LTV:CAC) | | `/ads test` | A/B test design (hypothesis, significance, sample size) | | `/ads report` | PDF audit report generation for client deliverables | | `/ads dna ` | Extract brand DNA from website → `brand-profile.json` | | `/ads create` | Generate campaign concepts + copy briefs → `campaign-brief.md` | | `/ads generate` | Generate AI ad images from brief → `ad-assets/` | | `/ads photoshoot` | Product photography in 5 styles | ## Development Rules - Keep SKILL.md files under 500 lines / 5000 tokens - Reference files should be focused; aim for under 350 lines. Split when a single reference exceeds that and starts mixing concerns - Scripts must have docstrings, CLI interface, and JSON output - Follow kebab-case naming for all skill directories - Agents invoked via Task tool with `context: fork`, never via Bash - No hardcoded credentials; use MCP servers for external API access ## Release Blog Post After cutting a new release (git tag + `gh release create`), run: ``` /release-blog ``` This generates a blog post on https://agricidaniel.com/blog/, handles cover image generation, SEO metadata, FAQ schema, internal linking, sitemap/llms.txt updates, Vercel deployment, and Google indexing.