Skip to content
ads logo

ads

Comprehensive paid advertising audit and optimization for any business type. Performs full multi-platform audits (Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads), single-platform deep analysis, conversion tracking health checks, creative quality assessment, budget allocation optimi...

SKILL.md

Full skill instructions

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

CommandWhat it does
/​ads auditFull multi-platform audit with parallel subagent delegation
/​ads googleGoogle Ads deep analysis (Search, PMax, YouTube)
/​ads metaMeta Ads deep analysis (FB, IG, Advantage+)
/​ads youtubeYouTube Ads specific analysis
/​ads linkedinLinkedIn Ads deep analysis (B2B, Lead Gen)
/​ads tiktokTikTok Ads deep analysis (Creative, Shop, Smart+)
/​ads microsoftMicrosoft/​Bing Ads deep analysis (Copilot, Import)
/​ads creativeCross-platform creative quality audit
/​ads landingLanding page quality assessment for ad campaigns
/​ads budgetBudget allocation and bidding strategy review
/​ads plan <business-type>Strategic ad plan with industry templates
/​ads competitorCompetitor ad intelligence analysis

Orchestration Logic

When the user invokes /​ads audit, delegate to subagents in parallel:

  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, etc.), load the relevant sub-skill directly.

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/. When sub-skills or agents reference ads/​references/​*.md, resolve to ~/​.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. Cross-platform aggregate weighted by budget share:

Aggregate = Sum(Platform_Score x Platform_Budget_Share)

Grading

GradeScoreAction Required
A90-100Minor optimizations only
B75-89Some improvement opportunities
C60-74Notable issues need attention
D40-59Significant problems present
F<40Urgent intervention required

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