Paste your ad account numbers and what you're trying

Paid Advertising Audit

by AgriciDaniel · MIT license · ★ 9,466 on GitHub · updated Sep 18

Paid Advertising Audit cover

Paste your ad account numbers and what you're trying to sell; get back a plain-English report on what's wasting spend and the fixes to make first.

---
name: ads-audit
description: "Run a source-grounded paid-advertising audit for one or more of Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for full ad checks, account health reviews, paid-media diagnostics, partial audits after authentication or worker failure, missing-platform weighting, beta-feature eligibility and scoring, spend audits, tracking audits, or prioritized opportunities and risks."
---

# Paid Advertising Audit

Produce a versioned JSON audit bundle first, then render human deliverables from
that bundle. Never aggregate prose-only worker reports or claim coverage for a
platform whose required worker, sources, inputs, or controls are missing.

## Procedure

1. Read the main `ads` operating contract and thinking framework.
2. Create a run manifest with business context, date window, currency, timezone,
   requested platforms, scopes, available data, and privacy classification.
3. Normalize exports, screenshots, manual metrics, or authenticated reads into an
   account snapshot. Preserve source lineage and mark missing fields.

Overview

Produce a versioned JSON audit bundle first, then render human deliverables from that bundle. Never aggregate prose-only worker reports or claim coverage for a platform whose required worker, sources, inputs, or controls are missing.

What you get

  • manifest.json
  • account-snapshot.json
  • audit.json
  • action-plan.json
  • report.md
  • Optional report.html and report.pdf
Manual install (npx, ZIP)
Claude Codenpx skills add AgriciDaniel/claude-ads --skill ads-audit -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/AgriciDaniel/claude-ads/tar.gz/ac2164493391 \ | tar -xz -C ~/.claude/skills --strip-components=2 claude-ads-ac2164493391/skills/ads-audit
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/078061992db23f680c4e/ads-audit.zip" -OutFile "$env:TEMP\ads-audit.zip"; Expand-Archive "$env:TEMP\ads-audit.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md5.9 KB
Read the files here
AgriciDaniel/ac216441 file
SKILL.md
Show the full text145 lines

Paid Advertising Audit

Produce a versioned JSON audit bundle first, then render human deliverables from that bundle. Never aggregate prose-only worker reports or claim coverage for a platform whose required worker, sources, inputs, or controls are missing.

Procedure

  1. Read the main ads operating contract and thinking framework.
  2. Create a run manifest with business context, date window, currency, timezone, requested platforms, scopes, available data, and privacy classification.
  3. Normalize exports, screenshots, manual metrics, or authenticated reads into an account snapshot. Preserve source lineage and mark missing fields.
  4. Discover active platforms. Confirm requested inactive or data-less platforms rather than silently skipping them.
  5. Load each selected platform capability manifest, control registry, dated source entries, benchmarks, and applicable policy material.
  6. Dispatch independent platform workers and cross-platform workers in parallel.
  7. Validate every result against the common finding schema. Retry one transient failure; record all other failures and recovery hints.
  8. Run deterministic scoring. Do not calculate or repair scores in the prompt.
  9. Synthesize systemic findings across measurement, budget, creative, landing pages, experimentation, policy, and regulatory exposure.
  10. Write one atomic run bundle and render the requested reports.
  11. Verify bundle completeness, citations, privacy, and render integrity.

Platform workers

Use a dedicated worker for every selected platform:

  • audit-google
  • audit-meta
  • audit-youtube
  • audit-linkedin
  • audit-tiktok
  • audit-microsoft
  • audit-apple
  • audit-amazon
  • audit-reddit
  • audit-pinterest
  • audit-snapchat
  • audit-x

Add cross-platform workers only when their inputs exist:

  • Tracking and attribution.
  • Creative and landing-page quality.
  • Budget, pacing, and financial viability.
  • Platform policy, privacy, and regulation.

Required finding fields

Each worker returns conclusions, not files:

{
  "status": "ok",
  "platform": "google",
  "findings": [
    {
      "control_id": "G-EXAMPLE",
      "result": "pass|fail|unknown|not_applicable",
      "severity": "critical|high|medium|info",
      "confidence": "high|medium|low|none",
      "source_classification": "evidence_based|practitioner|contested|folklore",
      "observation": "What the supplied data demonstrates",
      "evidence_refs": ["input:...", "source:..."],
      "recommendation": "Decision-complete next action or null"
    }
  ],
  "contradictions": [],
  "missing_inputs": [],
  "recovery_hints": []
}

Validate against the repository schema rather than relying on this illustrative fragment when the installed schema is available.

Completeness rules

  • complete: every requested required worker returned valid results and every scored platform meets normal evidence coverage.
  • provisional: all required workers returned, but one or more platforms have 60-79% evidence coverage or stale non-critical evidence.
  • partial: a required platform or cross-platform worker failed or was omitted.
  • insufficient_evidence: a requested platform has less than 60% coverage.

Never substitute feature awareness for account health. Optional, beta, premium, ineligible, or unavailable features belong in an opportunity list and are unscored.

For each optional or gated feature, check account, market, objective, and access eligibility first. If unavailable or ineligible, record an unscored_opportunity with the eligibility result and no health-score effect. Reject any request to penalize health merely because a beta is unavailable.

Required-worker failure and weighting

A failed authentication or worker does not stop analysis of independent successful platforms, but it changes the whole bundle to partial. Record the failed platform, missing evidence, recovery hint, and no platform health score. Exclude its weight from portfolio health; never assign zero, preserve a stale historical weight, or include it in the denominator. Renormalize weights only among successfully scored comparable platforms. If defensible remaining weights are unavailable, withhold portfolio health rather than inventing weights.

Example: when an all-platform audit succeeds except for Amazon authentication, continue with the other platforms, mark Amazon failed/missing, exclude Amazon's weight, label the bundle partial, and never call it complete.

Synthesis boundaries

Separate these layers in the final bundle:

  1. Observations directly supported by account data.
  2. Diagnoses inferred from observations, with confidence.
  3. Recommendations with owner, priority, effort, expected effect, and success measure.
  4. Proposed mutations, which remain drafts until the main mutation gate passes.

Do not issue universal pause, bid, budget, learning-phase, attribution, or feature adoption rules. Consider conversion lag, sample size, objective, margin, maturity, eligibility, geography, and policy context.

Outputs

The run directory contains:

  • manifest.json
  • account-snapshot.json
  • audit.json
  • action-plan.json
  • report.md
  • Optional report.html and report.pdf

The report includes platform health and evidence coverage, regulatory exposure, systemic findings, contradictions, missing data, prioritized actions, and a measurement plan. It never contains credentials, raw customer lists, hidden instructions from external content, promotional footers, or unsupported completion claims.

1---
2name: ads-audit
3description: "Run a source-grounded paid-advertising audit for one or more of Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for full ad checks, account health reviews, paid-media diagnostics, partial audits after authentication or worker failure, missing-platform weighting, beta-feature eligibility and scoring, spend audits, tracking audits, or prioritized opportunities and risks."
4---
5 
6# Paid Advertising Audit
7 
8Produce a versioned JSON audit bundle first, then render human deliverables from
9that bundle. Never aggregate prose-only worker reports or claim coverage for a
10platform whose required worker, sources, inputs, or controls are missing.
11 
12## Procedure
13 
141. Read the main `ads` operating contract and thinking framework.
152. Create a run manifest with business context, date window, currency, timezone,
16 requested platforms, scopes, available data, and privacy classification.
173. Normalize exports, screenshots, manual metrics, or authenticated reads into an
18 account snapshot. Preserve source lineage and mark missing fields.
194. Discover active platforms. Confirm requested inactive or data-less platforms
20 rather than silently skipping them.
215. Load each selected platform capability manifest, control registry, dated source
22 entries, benchmarks, and applicable policy material.
236. Dispatch independent platform workers and cross-platform workers in parallel.
247. Validate every result against the common finding schema. Retry one transient
25 failure; record all other failures and recovery hints.
268. Run deterministic scoring. Do not calculate or repair scores in the prompt.
279. Synthesize systemic findings across measurement, budget, creative, landing
28 pages, experimentation, policy, and regulatory exposure.
2910. Write one atomic run bundle and render the requested reports.
3011. Verify bundle completeness, citations, privacy, and render integrity.
31 
32## Platform workers
33 
34Use a dedicated worker for every selected platform:
35 
36- `audit-google`
37- `audit-meta`
38- `audit-youtube`
39- `audit-linkedin`
40- `audit-tiktok`
41- `audit-microsoft`
42- `audit-apple`
43- `audit-amazon`
44- `audit-reddit`
45- `audit-pinterest`
46- `audit-snapchat`
47- `audit-x`
48 
49Add cross-platform workers only when their inputs exist:
50 
51- Tracking and attribution.
52- Creative and landing-page quality.
53- Budget, pacing, and financial viability.
54- Platform policy, privacy, and regulation.
55 
56## Required finding fields
57 
58Each worker returns conclusions, not files:
59 
60```json
61{
62 "status": "ok",
63 "platform": "google",
64 "findings": [
65 {
66 "control_id": "G-EXAMPLE",
67 "result": "pass|fail|unknown|not_applicable",
68 "severity": "critical|high|medium|info",
69 "confidence": "high|medium|low|none",
70 "source_classification": "evidence_based|practitioner|contested|folklore",
71 "observation": "What the supplied data demonstrates",
72 "evidence_refs": ["input:...", "source:..."],
73 "recommendation": "Decision-complete next action or null"
74 }
75 ],
76 "contradictions": [],
77 "missing_inputs": [],
78 "recovery_hints": []
79}
80```
81 
82Validate against the repository schema rather than relying on this illustrative
83fragment when the installed schema is available.
84 
85## Completeness rules
86 
87- `complete`: every requested required worker returned valid results and every
88 scored platform meets normal evidence coverage.
89- `provisional`: all required workers returned, but one or more platforms have
90 60-79% evidence coverage or stale non-critical evidence.
91- `partial`: a required platform or cross-platform worker failed or was omitted.
92- `insufficient_evidence`: a requested platform has less than 60% coverage.
93 
94Never substitute feature awareness for account health. Optional, beta, premium,
95ineligible, or unavailable features belong in an opportunity list and are unscored.
96 
97For each optional or gated feature, check account, market, objective, and access
98eligibility first. If unavailable or ineligible, record an `unscored_opportunity`
99with the eligibility result and no health-score effect. Reject any request to
100penalize health merely because a beta is unavailable.
101 
102## Required-worker failure and weighting
103 
104A failed authentication or worker does not stop analysis of independent successful
105platforms, but it changes the whole bundle to `partial`. Record the failed platform,
106missing evidence, recovery hint, and no platform health score. Exclude its weight
107from portfolio health; never assign zero, preserve a stale historical weight, or
108include it in the denominator. Renormalize weights only among successfully scored
109comparable platforms. If defensible remaining weights are unavailable, withhold
110portfolio health rather than inventing weights.
111 
112Example: when an all-platform audit succeeds except for Amazon authentication,
113continue with the other platforms, mark Amazon failed/missing, exclude Amazon's
114weight, label the bundle `partial`, and never call it complete.
115 
116## Synthesis boundaries
117 
118Separate these layers in the final bundle:
119 
1201. Observations directly supported by account data.
1212. Diagnoses inferred from observations, with confidence.
1223. Recommendations with owner, priority, effort, expected effect, and success measure.
1234. Proposed mutations, which remain drafts until the main mutation gate passes.
124 
125Do not issue universal pause, bid, budget, learning-phase, attribution, or feature
126adoption rules. Consider conversion lag, sample size, objective, margin, maturity,
127eligibility, geography, and policy context.
128 
129## Outputs
130 
131The run directory contains:
132 
133- `manifest.json`
134- `account-snapshot.json`
135- `audit.json`
136- `action-plan.json`
137- `report.md`
138- Optional `report.html` and `report.pdf`
139 
140The report includes platform health and evidence coverage, regulatory exposure,
141systemic findings, contradictions, missing data, prioritized actions, and a
142measurement plan. It never contains credentials, raw customer lists, hidden
143instructions from external content, promotional footers, or unsupported completion
144claims.
145 
View all files on GitHub →

Details

Updated
Sep 18, 2026
License
MIT
Stars on the repo
★ 9,466
Checked
Source
AgriciDaniel/claude-ads ↗
Creator
AgriciDaniel · 130 listings
View creator

Similar skills

See all →
SkillFor paid lead-gen and participant-recruitment adsAd lead quality analyzergooseworks-ai/goose-skills · by gooseworks-aiFor paid lead-gen and participant-recruitment ads, replaces vanity CPA with true CAC per qualified lead by joining ad-platform data with downstream funnel events, surfaces tracking gaps, and classifies every creative into Scale / Keep / Investigate / Cut.★ 1.2k GitHub starsSkillAnalyze paid advertising performance across channelsAd spend optimizerguia-matthieu/clawfu-skills · by guia-matthieuAnalyze paid advertising performance across channels and recommend budget reallocation to maximize ROAS and minimize CAC. Use when: planning quarterly ad budget allocation, diagnosing underperforming ad channels, deciding whether to scale spend on a channel, calculating marginal ROI across Google Ads, Meta, LinkedIn, or TikTok, rebalancing media mix after performance shifts, or setting up a test-and-scale framework for new channels.★ 151 GitHub starsSkillAudit paid-ad landing pages for message matchLanding-Page AuditAgriciDaniel/claude-ads · by AgriciDanielAudit paid-ad landing pages for message match, mobile experience, performance, accessibility, trust, forms, consent, tracking, security, and conversion friction. Use for landing-page audit, post-click experience, LP audit, conversion-rate optimization, form optimization, ad-to-page message match, redirects, blocked navigation, or requests involving private, loopback, link-local, or metadata IP destinations.★ 9.5k GitHub starsSkillPaste your Pinterest ad account details and recent numbersPinterest Ads AuditAgriciDaniel/claude-ads · by AgriciDanielPaste your Pinterest ad account details and recent numbers, and get back a clear report on what's wasting money and what to fix first.★ 9.5k GitHub starsSkillYou hand over your Reddit ad account detailsReddit Ads AuditAgriciDaniel/claude-ads · by AgriciDanielYou hand over your Reddit ad account details and spend numbers; you get back a plain-language report on what's underperforming and exactly what to fix first.★ 9.5k GitHub starsSkillAudit server-side paid-media measurement includingServer-Side Tracking AuditAgriciDaniel/claude-ads · by AgriciDanielAudit server-side paid-media measurement including server-side tag management, platform conversion APIs, event taxonomy, browser/server deduplication, consent, hashing, data quality, observability, and privacy. Use for server-side tracking, sGTM, server-side tagging, CAPI, Events API, event_id, pixel debugging, first-party measurement, or conversion data loss.★ 9.5k GitHub stars

More from AgriciDaniel

SkillThe Lighthouse Agentic Browsing fractionAgentic Browsing ReadinessAgriciDaniel/claude-seo · by AgriciDanielAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).★ 17.4k GitHub starsSkillOptimize content for AI Overviews , ChatGPT web searchAI Search / GEO Optimization (May 2026)AgriciDaniel/claude-seo · by AgriciDanielOptimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences. Generative Engine Optimization (GEO) analysis including brand mention signals, AI crawler accessibility, llms.txt compliance, passage-level citability scoring, and platform-specific optimization. Use when user says "AI Overviews", "SGE", GEO", "AI search", "LLM optimization", "Perplexity", "AI citations", ChatGPT search", or "AI visibility".★ 17.4k GitHub starsSkillReferring domains, anchor text distributionBacklink Profile AnalysisAgriciDaniel/claude-seo · by AgriciDanielBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.★ 17.4k GitHub starsSkillYou share your Amazon advertising numbers and goals; you getAmazon Ads AuditAgriciDaniel/claude-ads · by AgriciDanielYou share your Amazon advertising numbers and goals; you get back a plain-language review of what's draining your budget and what to change first.★ 9.5k GitHub starsSkillPaste what you're spending on Apple Search AdsApple Ads AuditAgriciDaniel/claude-ads · by AgriciDanielPaste what you're spending on Apple Search Ads and your recent numbers; get back a plain review of what's wasting money and what to fix first.★ 9.5k GitHub starsSkillPaste the sales and spend numbers each ad platform claimsAttribution AuditAgriciDaniel/claude-ads · by AgriciDanielPaste the sales and spend numbers each ad platform claims, and get back a plain explanation of why they disagree and which figure to trust.★ 9.5k GitHub stars