amazon-ads-audit
Skill8 starsChanged 53 days agoMITView on GitHub
对 Amazon Ads 账户、广告活动与投放结构进行系统体检,识别数据质量、浪费、预算、转化、结构和增长机会。适用于广告体检、账户诊断、周/月复盘、接手新账户等场景。
In this repository16 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- amazon-ads-optimizerSkill
- anomaly-detectionSkill
- bid-optimizationSkill
- budget-optimizationSkill
- campaign-health-monitorSkill
- experiment-plannerSkill
- growth-opportunity-finderSkill
- keyword-optimizationSkill
- negative-targetingSkill
- performance-drop-diagnosisSkill
- placement-optimizationSkill
- post-change-reviewSkill
- profitability-analysisSkill
- search-term-analysisSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 3 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Use for account audits, account handovers, broad health reviews, or when the user wants the most important paid-media risks and …
- Very specific: line 18
Default mode: Suggest. Never mutate a live account.
- Very specific: line 22
When a conclusion depends on live MCP/API/connector data, load ../../references/connector-capability.md before interpreting missing or …
- Distinctive: line 33
Read this file first, then load only what is needed:
- Distinctive: line 40
Do not load specialist Skills unless a material finding needs their decision logic.
- Very specific: line 89
Do not make high-confidence optimization decisions from unresolved marketplace/currency/date/attribution/source mismatches.
- Very specific: line 91
Default to Hold, Directional or specialist review when evidence is insufficient.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Amazon Ads Audit
Use for account audits, account handovers, broad health reviews, or when the user wants the most important paid-media risks and opportunities across several domains.
Default mode: Suggest. Never mutate a live account.
Connector capability gate
When a conclusion depends on live MCP/API/connector data, load ../../references/connector-capability.md before interpreting missing or empty fields. If a machine-readable capability snapshot is available, identify the exact required capability IDs and run ../../scripts/evaluate_connector_capability_gate.py before metric interpretation.
Pass— continue with the Skill's normal evidence, sufficiency, lineage and safety checks.Degraded— do not make a high-confidence dependent recommendation; keep the result toDirectional,Hold,Alternate Source,Missing Data, orManual Review.Blocked— do not treat the dependent observation as action-safe until the capability is resolved or an allowed alternate source is verified.missing_evidence_policy = never_zero—Partial,Unsupported,Unknown, or absent connector capability is never a numeric zero, unchanged state, or proof that the platform lacks the feature.
This gate is read-only and does not authorize live Amazon Ads mutation.
Progressive loading
Read this file first, then load only what is needed:
- full audit workflow and aggregation safety:
references/account-audit-framework.md; - metric definitions:
../../references/amazon-ads-metrics.md; - cross-source/semantic/backfill comparability:
../../references/data-lineage.md; - decision/execution boundaries:
../../references/decision-boundaries.md.
Do not load specialist Skills unless a material finding needs their decision logic.
Required context
Collect or mark missing:
- marketplace and profile/account scope;
- currency, timezone, exact date/comparison windows and attribution maturity;
- source freshness/completeness and truncation/coverage warnings;
- profile/account and campaign base metrics;
- keyword/target, search term and placement views when available;
- budget/bid/state/structure context;
- stated objective or target economics;
- retail/product context when conversion or scaling is material.
Workflow
- Reliability gate — validate scope, dates, attribution, freshness and source comparability.
- Canonical totals — choose one additive account grain and reconcile it to a complete campaign view when possible.
- Metric integrity — sum compatible base metrics only when their
aggregation_semanticsis explicitly additive and source rows are disjoint; use../../scripts/evaluate_metric_aggregation_gate.pywhen the semantic envelope is available. Never add overlapping entity grains, de-duplicated/non-additive metrics, or ratio KPIs; recompute ratios from compatible base components. - Account result — establish spend, attributed sales/orders, efficiency and business-objective fit.
- Driver analysis — rank material contributors by absolute impact, then decompose through campaign/product/target/query/placement views.
- Structure and routing — identify conflicting intents, Mixed-ASIN risk, unclear query routing, duplication, fragmentation or budget interdependence.
- Waste/protection — identify evidence-backed waste without turning zero orders/high ACOS into automatic negatives or pauses.
- Growth/headroom — identify qualified opportunities only after economics, retail readiness and marginal headroom checks.
- Prioritize — blockers/risks first, then efficiency, growth and longer-term structure.
- Route specialized findings to matching Skills instead of duplicating their rules.
Output contract
Return:
- scope and data confidence;
- executive verdict;
- canonical account scorecard;
- largest driver/contribution findings;
- structure/routing and retail/economic findings;
- prioritized issues/opportunities with evidence and confidence;
- specialist action proposals when justified;
- Hold / Need more data;
- next review/measurement.
Safety boundaries
- Missing rows are not automatically zero.
- Profile/campaign/keyword/search-term/placement totals are not additive when they describe overlapping traffic.
- Account ratios must be recomputed from compatible aggregate components rather than averaged across rows.
aggregation_semantics = unknownis not permission to sum.non_additive_deduplicatedandratio_or_derivedmetrics are never direct-sum safe; use a source-provided aggregate or recompute from compatible base metrics as appropriate.- TACOS requires compatible total retail sales; profit claims require sufficient cost/economic inputs.
- Do not make high-confidence optimization decisions from unresolved marketplace/currency/date/attribution/source mismatches.
- Conversion-led issues must consider stock, Featured Offer / Buy Box, price, promotions, listing and variation-family changes.
- Default to
Hold,Directionalor specialist review when evidence is insufficient. - Any real mutation requires explicit authorization and an external Connector / Executor.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

