Agent skill

Ad Account Auditor

by aaron-he-zhu in aaron-he-zhu/aaron-marketing-skills

A skill your agent uses when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes…

Apache-2.0Auto-check passedMarketing & SEO

Install Ad Account Auditor

skills CLI
$ npx skills add aaron-he-zhu/aaron-marketing-skills --skill ad-account-auditor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aaron-he-zhu/aaron-marketing-skills ad-account-auditor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aaron-he-zhu/aaron-marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ad/activate/ad-account-auditor .claude/skills/ad-account-auditor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ad-account-auditor
GitHub stars
2.9k
Used in
2 other repos
Token cost
~2.2k tokens
SKILL.md length
747 words
Files
2 (incl. references)
Skills in repo
119
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes…

  • Works in 5 steps: Normalize currency, windows, IDs, lag,… → Score all 20 R1..S5 criteria from the… → Use Unknown for missing own-data truth,… → …
  • Auditing a paid ad account for incremental contribution
  • SKILL.md covers When This Must Trigger, Quick Start, Skill Contract and Data Sources, plus 9 more sections
  • Calls git

What it does

Ad Account Auditor is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes and a SHIP/FIX/BLOCK/UNDECIDED gate on own exported data. Not for campaign structure design — use campaign-architect; not for creative production — use ad-creative-builder. 付费广告账户审计/ROAS评分

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/auditor-runtime.md`). Compatibility notes: Claude Code and compatible agent-skill hosts

It sits in Marketing & SEO, covering Paid advertising. The repository describes itself as: 120 marketing skills as an AI marketing staff — plugin, portable skills, or an 8-bot team across 7 disciplines (narrative, SEO/GEO, social, email, paid, influencer, launch) on… The licence is Apache-2.0.

When your agent uses it

  • Auditing a paid ad account for incremental contribution
  • Measurement integrity before scaling
  • Runs a typed 20-item ROAS profile with verified vetoes and a SHIP/FIX/BLOCK/UNDECIDED gate on own exported data

Example prompts

  • “/ad-account-auditor”

Requirements

  • Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts
  • Pre-approved tools (allowed-tools): WebFetch

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Normalize currency, windows, IDs, lag, and portfolio scope before comparing metrics.
  2. Score all 20 R1..S5 criteria from the benchmark with source/date/type/confidence.
  3. Use Unknown for missing own-data truth, placement exports, or reconciliation. No data is not a veto and cannot be N/A merely because…
  4. Verify vetoes
  5. Run the typed scorer. Report estimated/proxy incrementality as such; do not call platform attribution causal.

What it can do on your machine

Read from SKILL.md and the folder at commit 0ab9024. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Claude Code and compatible agent-skill hosts

    From compatibility in the SKILL.md frontmatter.

Context cost

Ad Account Auditor loads about 2.2k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 747 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aaron-he-zhu/aaron-marketing-skills at commit 0ab9024, republished under its Apache-2.0 licence (© aaron-he-zhu). 747 words, ~2,192 tokens.

Download SKILL.mdSave it as .claude/skills/ad-account-auditor/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ad-account-auditor
description
Use when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes and a SHIP/FIX/BLOCK/UNDECIDED gate on own exported data. Not for campaign structure design — use campaign-architect; not for creative production — use ad-creative-builder. 付费广告账户审计/ROAS评分
allowed-tools
WebFetch
compatibility
Claude Code and compatible agent-skill hosts
slug
aaron-ad-account-auditor
displayName
Ad Account Auditor · 付费广告账户审计
summary
付费广告账户审计/ROAS评分
version
20.1.0
license
Apache-2.0
homepage
https://github.com/aaron-he-zhu/aaron-marketing-skills
when_to_use
Use when checking whether a paid account or portfolio is safe to launch or scale. Requires normalized own-data outcomes, attribution windows, currency…
argument-hint
<campaign + outcome exports> <currency/window/lag> [profile]
class
auditor
metadata.author
aaron-he-zhu

Ad Account Auditor

Audit one paid-media account or portfolio for incremental contribution and operating quality under declared constraints. Platform-reported ROAS is one input, never the objective or truth set by itself.

When This Must Trigger

  • Before launching, materially increasing spend, or changing a risky bid/targeting strategy.
  • When tracking, attribution inflation, unsafe placements, claims, or wasted spend are in doubt.
  • When the user requests a ROAS/RQS account audit from their exports.

Quick Start

text
Audit this USD account for direct response using 7-day click, 3-day lag, and $120 CAC ceiling.
Run the incremental-profit profile against the holdout and order-ID exports.

Skill Contract

Reads: one normalized account/portfolio evidence set. Writes: only a permissioned v3 artifact. Done when: required context and all 20 states are explicit, vetoes use verified evidence, and scorer output is reported without executing spend changes.

This skill judges. conversion-signal-qa, attribution-reconciler, campaign-architect, ad-creative-builder, and budget-pacing-monitor build/fix the inputs. Never enable campaigns, change bids, upload audiences, or scale budgets without separate explicit approval.

For a pre-launch account-audit request, use the narrow route conversion-signal-qa immediately before this gate. Do not automatically insert placement-exclusion-manager or conversion-value-mapper between signal QA and the audit; missing placement or value evidence remains Unknown in this run, and those sibling builders become separate remediation only when the user requests them or the completed gate identifies the corresponding finding.

Data Sources

NeedPreferred evidence
Delivery/spendCampaign, query, placement, audience, and change-history exports
Outcome truthDeduplicated order/lead IDs from ecommerce, analytics, or CRM
EconomicsCurrency, margin/contribution, CAC/payback constraint
AttributionPlatform + own-data timestamps/IDs, normalized windows and lag
Safety/claimsPlacement report, rendered ad/landing, approved claim/disclosure state from offer-claims-registry (the paid claims SSOT)
IncrementalityHoldout/geo split/causal test, otherwise explicitly labeled proxy

Instructions

Runtime Reads
  • ../../../references/auditor-runbook.md
  • ../../../references/scoring-semantics.md
  • ../../../references/roas-benchmark.md
  • ../../../references/runtime-invocation.md
  • references/auditor-runtime.md
Runtime and Setup

Read ../../../references/auditor-runbook.md, scoring-semantics.md, roas-benchmark.md, and the ROAS catalog entry. Standalone installs use bundled immutable references/auditor-runtime.md; never fetch mutable main. Before deterministic calls, follow runtime-invocation.md, resolve AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}", and require the scorer, validator, and typed catalogs. If unavailable, return score_state: NOT_SCORED / score_confidence: not_scored with no gate verdict or persistent artifact.

Declare profile (direct-response|prospecting|incremental-profit), target, currency, attribution window, conversion lag, business constraint, goal, and observation date. If any required context is missing, return NEEDS_INPUT/UNDECIDED.

Evidence and Scoring
  1. Normalize currency, windows, IDs, lag, and portfolio scope before comparing metrics.
  2. Score all 20 R1..S5 criteria from the benchmark with source/date/type/confidence.
  3. Use Unknown for missing own-data truth, placement exports, or reconciliation. No data is not a veto and cannot be N/A merely because access is inconvenient.
  4. Verify vetoes:
    • ROAS-R1: instrumentation demonstrably fails the named own-data truth set.
    • ROAS-R2: material double-counting/inflation is demonstrated.
    • ROAS-O1: material claim/disclosure failure against the offer-claims-registry approved state.
    • ROAS-O2: applicable platform/restricted-category violation.
    • ROAS-A1: placement evidence demonstrates a material safety breach.
  5. Run the typed scorer. Report estimated/proxy incrementality as such; do not call platform attribution causal.
Show full SKILL.md (304 more words)Show less

§2 ROAS Worked Examples

  • Complete direct-response profile, raw 78, no veto/fail: DONE/SHIP, final 78.
  • Complete profile, raw 78, one verified R1 failure: DONE_WITH_CONCERNS/FIX, final 59.
  • Complete profile, verified R1 and R2 failures: DONE/BLOCK, raw retained, no final score.
  • Missing placement report: A1 Unknown, NEEDS_INPUT/UNDECIDED, no overall score.

§3 ROAS Guardrails

  • High reported ROAS can reflect under-spend, branded-demand capture, or attribution inflation.
  • Learning-phase disruption is an S2 finding, not an automatic veto.
  • ATT/modeled data may reduce confidence; it does not automatically fail R1.
  • Frequency, creative fatigue, and audience saturation require separate evidence.
  • Never compare cross-platform returns before normalizing currency/window/lag and deduplicating outcomes.

§5 ROAS Translation

Lead with business impact and evidence. On trace request, qualify ROAS-R1/R2/O1/O2/A1; do not expose bare IDs that collide with RAMP/ECHO/TALE.

Report and Verdict

Begin with the auditor-runbook's exact typed conversation header. Never replace status, verdict, or score_state with prose; list each explicitly missing qualified item as ``ID: `unknown``` before findings.

Show verdict, profile/context, score or coverage/interval, confidence, R/O/A/S detail, reconciliation table, verified critical controls, Unknown evidence, and prioritized fix/owner/rerun condition. The scorer owns status/verdict and the 59 ceiling.

Validation Checkpoints

  • Scope/currency/window/lag/constraint/goal are explicit.
  • Own-data outcome truth is separated from platform self-report.
  • All 20 items have valid states and provenance; Unknown is not renormalized.
  • Veto failures are positively verified.
  • No spend/account mutation occurred without separate approval.

Persistence

Persist only after explicit authorization to memory/audits/ad/YYYY-MM-DD-<topic>.md. Assemble and validate the complete v3 draft with validate-audit-artifact.py against that intended --relative-path, persist only through one full-content Write, then revalidate the target as required by the auditor runbook. Edit/shell/MCP mutations of the reserved sink are unsupported. Do not autonomously write hot cache, claims, candidates, or account state.

Reference Materials

Next Best Skill

© aaron-he-zhu, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in ad/activate/ad-account-auditor of aaron-he-zhu/aaron-marketing-skills.

  • SKILL.md
  • references/auditor-runtime.md

Open the folder on GitHubat commit 0ab9024

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in aaron-he-zhu/aaron-marketing-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ad Account Auditor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ad Account Auditor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ad Account Auditor this skillaaron-he-zhu/aaron-marketing-skills2.9k2 repos~2.2kAutomated safety check: PassApache-2.0
Ad CreativeLeoYeAI/openclaw-marketing-skills1k8 repos~3.4kAutomated safety check: PassCustom licence
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT
Paid Ads AuditAgriciDaniel/claude-ads9.9k—~1.5kAutomated safety check: PassMIT
Marketing OsYuzzyuk/marketing-os540—~2.5kAutomated safety check: PassMIT
AdsCesarjoquin/Marketing-Skills2021 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Ad Creative

    LeoYeAI/openclaw-marketing-skills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    1k GitHub starsUsed in 8 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check: notes
  • Paid Ads Audit

    AgriciDaniel/claude-ads

    Runs a source-grounded paid advertising audit across up to 12 ad platforms, with parallel platform workers, deterministic scoring and a versioned JSON bundle.

    9.9k GitHub stars~1.5k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    540 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Ads

    Cesarjoquin/Marketing-Skills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    202 GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • Official

    Reopens a fitted Meridian MMM from a saved file and runs budget allocation scenarios, producing an HTML report and a Python script that repeats the run.

    1.6k GitHub stars~1.1k tokensUpdated today
    Marketing & SEOAuto-check passed

More from aaron-he-zhu/aaron-marketing-skills

All 119 skills in this repo
  • Ad Creative Builder

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "write ad copy", "generate RSA headlines", or "build ad creative at volume"; produces ad units — RSA headlines/descriptions, hooks, and an angle matrix…

    2.9k GitHub starsUsed in 2 repos~2.2k tokens
    Auto-check passed
  • Ad Test Designer

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is this result statistically and practically material?"…

    2.9k GitHub starsUsed in 2 repos~2.8k tokens
    Auto-check passed
  • Bid Strategy Planner

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"; produces a bid-strategy choice (tCPA / tROAS / max-conversions /…

    2.9k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • Conversion Signal QA

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "QA my conversion tracking before launch", "check my UTMs / pixel / event firing", "set up a tracking pre-flight", or "set the dedup rule so Meta and…

    2.9k GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check passed
  • Creator Registry

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks "what did we pay this creator last time" or to "update the creator roster"; curates creator identity, rate, rights, exclusivity, compliance-event, and…

    2.9k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed
  • Deliverability QA

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "run a deliverability pre-flight before I send", "check my SPF/DKIM/DMARC/BIMI", "why am I landing in spam / promotions", or "score my sender reputation…

    2.9k GitHub starsUsed in 2 repos~3.6k tokens
    Auto-check passed

Categories

Questions about Ad Account Auditor

What does Ad Account Auditor do?

A skill your agent uses when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes…. Ad Account Auditor is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes and a SHIP/FIX/BLOCK/UNDECIDED gate on own exported data.

When should I use Ad Account Auditor?

Ad Account Auditor fits situations like: auditing a paid ad account for incremental contribution; measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes and a SHIP/FIX/BLOCK/UNDECIDED gate on own exported data.

How do I install Ad Account Auditor in Claude Code?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill ad-account-auditor -a claude-code`. Or copy the skill folder (ad/activate/ad-account-auditor in aaron-he-zhu/aaron-marketing-skills) into .claude/skills/ad-account-auditor in your project. Claude Code loads it when a task matches its description.

How do I install Ad Account Auditor in Codex?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill ad-account-auditor -a codex`. Or copy the skill folder (ad/activate/ad-account-auditor in aaron-he-zhu/aaron-marketing-skills) into .agents/skills/ad-account-auditor in your project. Codex loads it when a task matches its description.

Can I use Ad Account Auditor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill ad-account-auditor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ad-account-auditor, .gemini/skills/ad-account-auditor, .github/skills/ad-account-auditor and .opencode/skills/ad-account-auditor in your project.

What does Ad Account Auditor need to run?

Going by SKILL.md and its folder, Ad Account Auditor needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: WebFetch. Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts.

Does Ad Account Auditor access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ad Account Auditor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ad Account Auditor use?

Ad Account Auditor is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ad Account Auditor use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Ad Account Auditor?

Skills that share tags, products or a category with Ad Account Auditor: Ad Creative (LeoYeAI/openclaw-marketing-skills, 1k stars), Blog Google (AgriciDaniel/claude-blog, 2.3k stars), Paid Ads Audit (AgriciDaniel/claude-ads, 9.9k stars) and Marketing Os (Yuzzyuk/marketing-os, 540 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ad Account Auditor?

aaron-he-zhu (a GitHub user) maintains it in aaron-he-zhu/aaron-marketing-skills, which has 2,894 GitHub stars. The repository holds 119 skills in this directory. The repository was last updated on October 10, 2026.

Source: aaron-he-zhu/aaron-marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.