Agent skill

ads-audit

Full multi-platform paid advertising audit with parallel subagent delegation. Analyzes Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, and Microsoft Ads accounts. Generates health score per platform and aggregate score. Use when user says audit, full ad check, analyze my ads, account health check, or PPC audit.

View SKILL.md on GitHub Repository
Stars 2,312
Forks 393

Install this agent skill to your Project

npx add-skill https://github.com/AgriciDaniel/claude-ads/tree/main/skills/ads-audit

SKILL.md

Full Multi-Platform Ads Audit

Process

  1. Collect account data: request exports, screenshots, or API access
  2. Validate: confirm at least one platform's data is available before proceeding
  3. Detect business type: analyze account signals per ads orchestrator
  4. Identify active platforms: determine which platforms are in use
  5. Delegate to subagents (if available, otherwise run inline sequentially):
    • audit-google: Conversion tracking, wasted spend, structure, keywords, ads, settings (G01-G74)
    • audit-meta: Pixel/CAPI health, creative fatigue, structure, audience (M01-M46)
    • audit-creative: LinkedIn, TikTok, Microsoft creative checks + cross-platform synthesis
    • audit-tracking: LinkedIn, TikTok, Microsoft tracking + cross-platform tracking health
    • audit-budget: LinkedIn, TikTok, Microsoft budget/bidding + cross-platform allocation
    • audit-compliance: All-platform compliance, settings, performance benchmarks
  6. Validate: verify each subagent returned valid scores with required fields before aggregating
  7. Score: calculate per-platform and aggregate Ads Health Score (0-100)
  8. Report: generate prioritized action plan with Quick Wins

Data Collection

Ask the user for available data. Accept any combination:

  • Google Ads: account export, Change History, Search Terms Report
  • Meta Ads: Ads Manager export, Events Manager screenshot, EMQ scores
  • LinkedIn Ads: Campaign Manager export, Insight Tag status
  • TikTok Ads: Ads Manager export, Pixel/Events API status
  • Microsoft Ads: account export, UET tag status, import validation results

If no exports available, audit from screenshots or manual data entry.

Scoring

Read ads/references/scoring-system.md for full algorithm.

Per-Platform Weights

Platform Category Weights
Google Conversion 25%, Waste 20%, Structure 15%, Keywords 15%, Ads 15%, Settings 10%
Meta Pixel/CAPI 30%, Creative 30%, Structure 20%, Audience 20%
LinkedIn Tech 25%, Audience 25%, Creative 20%, Lead Gen 15%, Budget 15%
TikTok Creative 30%, Tech 25%, Bidding 20%, Structure 15%, Performance 10%
Microsoft Tech 25%, Syndication 20%, Structure 20%, Creative 20%, Settings 15%

Aggregate Score

Aggregate = Sum(Platform_Score x Platform_Budget_Share)
Grade: A (90-100), B (75-89), C (60-74), D (40-59), F (<40)

Output Files

  • ADS-AUDIT-REPORT.md: Comprehensive multi-platform findings
  • ADS-ACTION-PLAN.md: Prioritized recommendations (Critical > High > Medium > Low)
  • ADS-QUICK-WINS.md: Items fixable in <15 minutes with high impact

Report Structure

Executive Summary

  • Aggregate Ads Health Score (0-100) with grade
  • Per-platform scores
  • Business type detected
  • Active platforms identified
  • Top 5 critical issues across all platforms
  • Top 5 quick wins across all platforms

Per-Platform Sections

Each platform section includes:

  • Platform Health Score with grade
  • Category breakdown with pass/warning/fail per check
  • Platform-specific Quick Wins
  • Detailed findings with remediation steps

Cross-Platform Analysis

  • Budget allocation assessment (actual vs recommended)
  • Tracking consistency (are all platforms tracking the same events?)
  • Creative consistency (is messaging aligned across platforms?)
  • Attribution overlap (are platforms double-counting conversions?)

Strategic Recommendations

  • Platform prioritization based on business type
  • Budget reallocation recommendations
  • Scaling opportunities (platforms/campaigns ready to scale)
  • Kill list (campaigns/ad groups to pause immediately)

Priority Definitions

  • 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)

Quick Wins Criteria

IF severity == "Critical" OR severity == "High"
AND estimated_fix_time < 15 minutes
THEN flag as Quick Win
SORT BY (severity_multiplier x estimated_impact) DESC

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

AgriciDaniel/claude-ads

ads

Multi-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Search Ads. 225+ checks with scoring, parallel agents, industry templates, and AI creative generation.

2,312 393
Explore
AgriciDaniel/claude-ads

ads-meta

Meta Ads deep analysis covering Facebook and Instagram advertising. Evaluates 46 checks across Pixel/CAPI health, creative diversity and fatigue, account structure, and audience targeting. Includes Advantage+ assessment. Use when user says Meta Ads, Facebook Ads, Instagram Ads, Advantage+, or Meta campaign.

2,312 393
Explore
AgriciDaniel/claude-ads

ads-generate

AI image generation for paid ad creatives. Reads campaign-brief.md and brand-profile.json to produce platform-sized ad images using banana-claude. Requires banana-claude (v1.4.1+) with nanobanana-mcp configured. Triggers on: generate ads, create images, make ad creatives, generate visuals, create ad images, generate campaign images, make the images, generate from brief.

2,312 393
Explore
AgriciDaniel/claude-ads

ads-microsoft

Microsoft/Bing Ads deep analysis covering search, Performance Max, Audience Network, and Copilot integration. Evaluates 20 checks with focus on Google import validation, unique Microsoft features, and cost advantage assessment. Use when user says Microsoft Ads, Bing Ads, Bing PPC, Copilot ads, or Microsoft campaign.

2,312 393
Explore
AgriciDaniel/claude-ads

ads-linkedin

LinkedIn Ads deep analysis for B2B advertising. Evaluates 25 checks across technical setup, audience targeting, creative quality, lead gen forms, and bidding strategy. Includes Thought Leader Ads, ABM, and predictive audiences. Use when user says LinkedIn Ads, B2B ads, sponsored content, lead gen forms, InMail, or LinkedIn campaign.

2,312 393
Explore
AgriciDaniel/claude-ads

ads-competitor

Competitor ad intelligence analysis across Google, Meta, LinkedIn, TikTok, and Microsoft. Analyzes competitor ad copy, creative strategy, keyword targeting, estimated spend, and identifies competitive gaps and opportunities. Use when user says competitor ads, ad spy, competitive analysis, competitor PPC, or ad intelligence.

2,312 393
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results