Ads — Multi-Platform Paid Advertising Audit & Optimization

Comprehensive ad account analysis across all major platforms (Google, Meta, LinkedIn, TikTok, Microsoft). Orchestrates 12 specialized sub-skills and 6 subagents.

Quick Reference

/ads audit

/ads google

/ads meta

/ads youtube

/ads linkedin

/ads tiktok

/ads microsoft

/ads creative

/ads landing

/ads budget

/ads plan <business-type>

/ads competitor

/ads score-creative

/ads trends

/ads report

/ads connect

/ads update-benchmarks

Orchestration Logic

When the user invokes

/ads audit

1. Collect account data (exports, screenshots, or API access details)
2. Detect business type and identify active platforms
3. Spawn subagents: audit-google, audit-meta, audit-creative, audit-tracking, audit-budget, audit-compliance
4. Collect results and generate unified report with Ads Health Score (0-100)
5. Create prioritized action plan with Quick Wins

For individual commands (

/ads google

/ads meta

Industry Detection

Detect business type from ad account signals:

• SaaS: trial_start/demo_request events, pricing page targeting, long attribution windows
• E-commerce: purchase events, product catalog/feed, Shopping/PMax campaigns
• Local Service: call extensions, location targeting, store visits, directions events
• B2B Enterprise: LinkedIn Ads active, ABM lists, high CPA tolerance ($50+), long sales cycle
• Info Products: webinar/course funnels, lead gen forms, low-ticket offers
• Mobile App: app install campaigns, in-app events, deep linking
• Real Estate: listing feeds, property-specific landing pages, geo-heavy targeting
• Healthcare: HIPAA compliance flags, healthcare-specific ad policies
• Finance: Special Ad Categories declared, financial products compliance
• Agency: multiple client accounts, white-label reporting needs

Quality Gates

Hard rules — never violate these:

• Never recommend Broad Match without Smart Bidding (Google)
• 3x Kill Rule: flag any ad group/campaign with CPA >3x target for pause
• Budget sufficiency: Meta ≥5x CPA per ad set, TikTok ≥50x CPA per ad group
• Learning phase: never recommend edits during active learning phase
• Compliance: always check Special Ad Categories for housing/employment/credit/finance
• Creative: never run silent video ads on TikTok (sound-on platform)
• Attribution: default to 7-day click / 1-day view (Meta), data-driven (Google)

Reference Files

Load these on-demand as needed — do NOT load all at startup.

Path resolution: All references are installed at

~/.claude/skills/ads/references/

ads/references/*.md

~/.claude/skills/ads/references/*.md

• references/scoring-system.md

  — Weighted scoring algorithm and grading thresholds

• references/benchmarks.md

  — Industry benchmarks by platform (CPC, CTR, CVR, ROAS)

• references/bidding-strategies.md

  — Bidding decision trees per platform

• references/budget-allocation.md

  — Platform selection matrix, scaling rules, MER

• references/platform-specs.md

  — Creative specifications across all platforms

• references/conversion-tracking.md

  — Pixel, CAPI, EMQ, ttclid implementation

• references/compliance.md

  — Regulatory requirements, ad policies, privacy

• references/google-audit.md

  — 74-check Google Ads audit checklist

• references/meta-audit.md

  — 46-check Meta Ads audit checklist

• references/linkedin-audit.md

  — 25-check LinkedIn Ads audit checklist

• references/tiktok-audit.md

  — 25-check TikTok Ads audit checklist

• references/microsoft-audit.md

  — 20-check Microsoft Ads audit checklist

Scoring Methodology

Ads Health Score (0-100)

Per-platform score using weighted algorithm from

references/scoring-system.md

Aggregate = Sum(Platform_Score x Platform_Budget_Share)

Grading

Priority Levels

• Critical: Revenue/data loss risk (fix immediately)
• High: Significant performance drag (fix within 7 days)
• Medium: Optimization opportunity (fix within 30 days)
• Low: Best practice, minor impact (backlog)

Sub-Skills

This skill orchestrates 12 specialized sub-skills:

1. ads-audit — Full multi-platform audit with parallel delegation
2. ads-google — Google Ads deep analysis (Search, PMax, YouTube)
3. ads-meta — Meta Ads deep analysis (FB, IG, Advantage+)
4. ads-youtube — YouTube Ads specific analysis
5. ads-linkedin — LinkedIn Ads deep analysis
6. ads-tiktok — TikTok Ads deep analysis
7. ads-microsoft — Microsoft/Bing Ads deep analysis
8. ads-creative — Cross-platform creative quality audit
9. ads-landing — Landing page quality for ad campaigns
10. ads-budget — Budget allocation and bidding strategy
11. ads-plan — Strategic ad planning with industry templates
12. ads-competitor — Competitor ad intelligence

Subagents

For parallel analysis during full audits:

• audit-google

  — Google Ads checks (G01-G74)

• audit-meta

  — Meta Ads checks (M01-M46)

• audit-creative

  — Creative quality for LinkedIn, TikTok, Microsoft

• audit-tracking

  — Conversion tracking health across all platforms

• audit-budget

  — Budget, bidding, structure for LinkedIn, TikTok, Microsoft

• audit-compliance

  — Compliance, settings, performance across all platforms

Python Tools (Pro Features)

These tools extend the skill with live data, AI analysis, and persistent tracking. All are optional — the skill works without them using manual data input.

Live API Connectors

Connect directly to ad platform APIs for automated auditing:

# Google Ads (requires google-ads SDK)
from tools.connectors.google_ads import GoogleAdsConnector
connector = GoogleAdsConnector("config.yaml")
data = connector.pull_audit_data("1234567890")

# Meta Ads (requires facebook-business SDK)
from tools.connectors.meta_marketing import MetaAdsConnector
connector = MetaAdsConnector(access_token="...", ad_account_id="act_123")
data = connector.pull_audit_data()

AI Creative Scorer

Vision-based creative analysis using Claude — scores on 8 dimensions:

from tools.creative_scorer import score_creative
result = score_creative("ad_image.png", platform="meta", industry="ecommerce")
# Returns: overall_score, improvements, ab_test_ideas, fatigue_risk

Audit History & Trends

Track score progression over time with SQLite persistence:

from tools.audit_store import AuditStore
store = AuditStore()
store.save_audit("google", 82, "B", checks=[...])
trends = store.get_trends("google")  # Shows score over 90 days

Competitor Intelligence

Automated competitor research via Meta Ad Library API:

from tools.competitor_intel import CompetitorIntel
intel = CompetitorIntel(meta_access_token="...")
ads = intel.fetch_meta_ads(page_id="123456789")
analysis = intel.analyze_creative_themes(ads)

PDF Report Generator

Generate polished PDF reports for clients:

from tools.report_gen import generate_pdf_report
generate_pdf_report(audit_data, "client_audit.pdf")

Real PageSpeed Insights

Real Core Web Vitals from Chrome users (replaces synthetic Playwright):

from tools.pagespeed import analyze_for_audit
result = analyze_for_audit("https://example.com", api_key="...")
# Returns real CrUX data: LCP, CLS, INP, TTFB

Benchmark Auto-Updater

Keep industry benchmarks fresh:

from tools.benchmark_updater import check_freshness, update_benchmarks
if check_freshness()["days_old"] > 90:
    update_benchmarks()  # Pulls latest from WordStream, LocaliQ