Index of every page on this site: llms.txt
All skills
agricidaniel avatar

/ads-audit

@fc3908e
by Agrici Danielagricidaniel/claude-ads11k stars
1,609
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/agricidaniel/claude-ads/ads-audit

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈110 tokens for metadata: the name and description. ≈1.6k when used: this file.

Description uses 5.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈442 characters, or 5.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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 worker result

Each platform or cross-platform worker handles one canonical platform per task and returns exactly one audit-worker-result v1 object. Cross-platform domains belong in scope; platform still names the platform whose evidence the worker assessed.

{
  "schema_version": "1.0.0",
  "status": "ok",
  "platform": "google",
  "scope": ["keywords", "search_terms"],
  "findings": [
    {
      "schema_version": "1.0.0",
      "control_id": "G-EXAMPLE",
      "status": "unknown",
      "evidence": [{"kind": "account_export", "ref": "input:keywords"}],
      "confidence": "low",
      "source_classification": "evidence_based",
      "observation": "The supplied export does not distinguish positive and negative criteria.",
      "diagnosis": "Keyword inventory completeness cannot be established.",
      "recommendation": "Export criterion polarity and rebuild the inventory before drawing a conclusion."
    }
  ],
  "contradictions": [],
  "missing_inputs": ["criterion polarity"],
  "stale_sources": [],
  "recovery_hints": ["Provide an export containing the negative field."]
}

Every envelope field is required. Validate against the installed audit-worker-result v1 schema. Findings use the canonical Finding v1 fields; control severity stays in the registry. Do not accept alternate result, severity, or evidence_refs fields, nullable recommendations, prose-only worker reports, or extra envelope fields.

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.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 alert1mo5 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill establishes a rigorous framework for auditing advertising accounts. It incorporates specific safety measures to protect data privacy and explicitly instructs the agent to ignore any malicious instructions found in analyzed external data.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

  • Runlayer9mo

    1/1 file flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at fc3908e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Activeupdated last month

README badge

README badge for agricidaniel/claude-ads/ads-audit