Claude Ads

Comprehensive paid advertising audit and optimization skill for Claude Code. Covers Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, and Microsoft Ads with 190 audit checks, industry-specific templates, and parallel subagent delegation.

Installation

One-Command Install (Unix/macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.sh | bash

One-Command Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.ps1 | iex

Manual Install

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
./install.sh          # Unix/macOS/Linux

.\install.ps1         # Windows PowerShell

Demo

Claude Ads Demo

Quick Start

# Start Claude Code
claude

# Run a full multi-platform audit
/ads audit

# Deep analysis for a single platform
/ads google
/ads meta
/ads linkedin

# Strategic planning by business type
/ads plan saas
/ads plan ecommerce
/ads plan local-service

# Cross-platform creative audit
/ads creative

# Budget and bidding strategy review
/ads budget

Commands

Command	Description
`/ads audit`	Full multi-platform audit with parallel subagent delegation
`/ads google`	Google Ads deep analysis (Search, PMax, Display, YouTube, Demand Gen)
`/ads meta`	Meta Ads deep analysis (FB, IG, Advantage+ Shopping)
`/ads youtube`	YouTube Ads specific analysis (Skippable, Shorts, Demand Gen)
`/ads linkedin`	LinkedIn Ads deep analysis (B2B, Lead Gen, TLA)
`/ads tiktok`	TikTok Ads deep analysis (Creative, Shop, Smart+)
`/ads microsoft`	Microsoft/Bing Ads deep analysis (Copilot, Import validation)
`/ads creative`	Cross-platform creative quality audit and fatigue detection
`/ads landing`	Landing page quality assessment for ad campaigns
`/ads budget`	Budget allocation and bidding strategy review
`/ads plan <type>`	Strategic ad plan with industry templates
`/ads competitor`	Competitor ad intelligence across all platforms

`/ads audit`

Full Multi-Platform Audit

Spawns 6 parallel subagents to analyze your ad accounts simultaneously:

audit-google — 74 checks across Search, PMax, Display, YouTube, Demand Gen
audit-meta — 46 checks across Pixel/CAPI, Creative, Structure, Audience
audit-creative — 21 cross-platform creative quality checks
audit-tracking — 7 conversion tracking health checks
audit-budget — 24 budget and bidding strategy checks
audit-compliance — 18 compliance and regulatory checks

Generates a unified Ads Health Score (0-100) with prioritized action plan.

`/ads plan <business-type>`

Strategic Ad Planning

Industry-specific templates with platform mix, campaign architecture, creative strategy, targeting, budget guidelines, and KPI targets.

Supported business types:

saas — Trial/demo focus, Google + LinkedIn primary
ecommerce — Shopping/PMax, ROAS-focused, seasonal
local-service — Google Search + LSA, call tracking, geo radius
b2b-enterprise — LinkedIn ABM, long sales cycle, pipeline metrics
info-products — Meta + YouTube, webinar/VSL funnels
mobile-app — Meta + Google UAC, MMP required, LTV:CPI
real-estate — Special Ad Category (housing), buyer/seller campaigns
healthcare — HIPAA compliance, LegitScript, restricted targeting
finance — Special Ad Category (credit), required disclosures
agency — Multi-client management, reporting framework
generic — Universal template with platform selection questionnaire

Features

190 Audit Checks

Comprehensive coverage across all platforms with weighted severity scoring:

Platform	Checks	Key Areas
Google Ads	74	Search, PMax, Display, YouTube, Demand Gen
Meta Ads	46	Pixel/CAPI, Creative, Structure, Audience
LinkedIn Ads	25	B2B targeting, TLA, Lead Gen forms
TikTok Ads	25	Creative-first, Smart+, TikTok Shop
Microsoft Ads	20	Google import, Copilot, MSAN

Ads Health Score (0-100)

Weighted scoring algorithm with severity multipliers:

Grade	Score	Action Required
A	90-100	Minor optimizations only
B	75-89	Some improvement opportunities
C	60-74	Notable issues need attention
D	40-59	Significant problems present
F	<40	Urgent intervention required

Industry Detection

Auto-detects business type from ad account signals (product feeds, conversion events, platform mix, targeting patterns) and loads industry-specific benchmarks and templates.

Quality Gates

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)

Reference Data

12 built-in reference files with 2026-current benchmarks, bidding decision trees, platform specifications, compliance requirements, and conversion tracking implementation guides.

Architecture

~/.claude/skills/ads/              # Main orchestrator
~/.claude/skills/ads/references/   # 12 RAG reference files
~/.claude/skills/ads-*/            # 12 sub-skills
~/.claude/skills/ads-plan/assets/  # 11 industry templates
~/.claude/agents/audit-*.md         # 6 parallel audit agents

How It Works

Orchestrator (/ads) routes commands to specialized sub-skills
Sub-skills provide deep single-domain analysis with structured output
Agents run in parallel during full audits for maximum speed
References load on-demand (RAG pattern) — only what's needed per analysis
Templates provide industry-specific strategy frameworks

Requirements

Claude Code CLI
Python 3.10+ with Playwright (optional, for live landing page analysis)

Uninstall

Unix/macOS/Linux

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.ps1 | iex

Related Projects

Claude SEO — Comprehensive SEO analysis skill for Claude Code

License

MIT License - see LICENSE for details.

Built for Claude Code by @AgriciDaniel