Skills · Business & ops

Paid Advertising Audit

Unverified32/40

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.

Originally by AgriciDaniel · MIT

Claude CodePartialHas SKILL.md but declares no allowed-tools — Claude Code will ask for permission each time
CursorPartialPlain prose you can paste in — but no Cursor rules file
CodexPartialPlain prose you can paste in — but no AGENTS.md
Gemini CLIPartialPlain prose you can paste in
CopilotPartialPlain prose you can paste in — but no Copilot instructions file
npx agentalley add ads-audit

This command does not work yet — the CLI is still being built. Until then, use Raw in the reader below to take the file.

Who is stuck, and on what

You're spending money on ads every month but you can't tell what's actually working and what's just burning cash. Nobody's ever gone through the whole account and told you straight where the waste is.

What it gives you

A prioritized written report showing which campaigns and platforms are leaking money, what's likely causing it, and the specific changes to make in order of impact.

When NOT to use it

It won't log into your accounts or change your campaigns for you — it reviews the numbers and details you provide.

The whole source

No sign-in, no blur, nothing truncated
ads-audit/SKILL.md145 lines5.9 KBRawView on GitHub
Frontmatter — 2 properties
nameads-audit
descriptionRun 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.
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---A5No allowed-tools declared — no way to tell what this skill may touch
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 

Reviews

Installed this one?Write the first review and take the Trailblazer badge.

Reviews only open after a real install, so this is empty — and we leave it empty rather than invent one.

Alternatives

Also in Business & ops