← Back to Skills Marketplace
danyangliu-sandwichlab

Ads Campaign Review

by danyangliu · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
322
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install campaign-retrospective-analyst
Description
Run retrospective analysis for campaigns on Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and DSP/programmatic channels.
README (SKILL.md)

Ads Campaign Review

Purpose

Core mission:

  • root-cause analysis, lesson extraction, next-cycle design

This skill is specialized for advertising workflows and should output actionable plans rather than generic advice.

When To Trigger

Use this skill when the user asks for:

  • ad execution guidance tied to business outcomes
  • growth decisions involving revenue, roas, cpa, or budget efficiency
  • platform-level actions for: Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, DSP/programmatic
  • this specific capability: root-cause analysis, lesson extraction, next-cycle design

High-signal keywords:

  • ads, advertising, campaign, growth, revenue, profit
  • roas, cpa, roi, budget, bidding, traffic, conversion, funnel
  • meta, googleads, tiktokads, youtubeads, amazonads, shopifyads, dsp

Input Contract

Required:

  • question_or_report_goal
  • metric_scope: KPI, dimensions, and date range
  • data_source_scope

Optional:

  • attribution_window
  • benchmark_reference
  • dashboard_filters
  • confidence_threshold

Output Contract

  1. Metric Definition Clarification
  2. Query Plan
  3. Result Summary
  4. Interpretation and Caveats
  5. Decision Recommendation

Workflow

  1. Disambiguate metric definitions and time window.
  2. Build query slices by platform, funnel, and audience.
  3. Compute trend deltas and variance drivers.
  4. Summarize findings with confidence level.
  5. Propose concrete next actions.

Decision Rules

  • If metric definitions conflict, lock one canonical definition before analysis.
  • If sample size is small, mark result as directional not conclusive.
  • If attribution changes materially alter result, show both views.

Platform Notes

Primary scope:

  • Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, DSP/programmatic

Platform behavior guidance:

  • Keep recommendations channel-aware; do not collapse all channels into one generic plan.
  • For Meta and TikTok Ads, prioritize creative testing cadence.
  • For Google Ads and Amazon Ads, prioritize demand-capture and query/listing intent.
  • For DSP/programmatic, prioritize audience control and frequency governance.

Constraints And Guardrails

  • Never fabricate metrics or policy outcomes.
  • Separate observed facts from assumptions.
  • Use measurable language for each proposed action.
  • Include at least one rollback or stop-loss condition when spend risk exists.

Failure Handling And Escalation

  • If critical inputs are missing, ask for only the minimum required fields.
  • If platform constraints conflict, show trade-offs and a safe default.
  • If confidence is low, mark it explicitly and provide a validation checklist.
  • If high-risk issues appear (policy, billing, tracking breakage), escalate with a structured handoff payload.

Code Examples

Query Spec Example

metric: roas
dimensions: [platform, campaign]
date_range: last_30d

Result Schema

{
  "platform": "Meta",
  "spend": 12000,
  "revenue": 42000,
  "roas": 3.5
}

Examples

Example 1: Daily report automation

Input:

  • Need 9AM daily summary for key campaigns
  • KPI: spend, cpa, roas

Output focus:

  • report schema
  • anomaly highlights
  • top next actions

Example 2: Attribution window comparison

Input:

  • 1d click vs 7d click disagreement
  • Decision needed for budget shift

Output focus:

  • side-by-side metric table
  • interpretation caveats
  • decision recommendation

Example 3: Traffic structure diagnosis

Input:

  • Revenue flat but traffic rising
  • Suspected quality decline

Output focus:

  • source mix decomposition
  • quality signal changes
  • corrective action plan

Quality Checklist

  • Required sections are complete and non-empty
  • Trigger keywords include at least 3 registry terms
  • Input and output contracts are operationally testable
  • Workflow and decision rules are capability-specific
  • Platform references are explicit and concrete
  • At least 3 practical examples are included
Usage Guidance
This skill appears coherent and low-risk as-is because it only contains instructions and asks for user-provided data. Before installing or using it: (1) confirm how you'll supply campaign data — provide exported reports or a read-only connector rather than high-privilege API keys if possible; (2) if you integrate platform connectors later, apply least-privilege credentials and review where the agent will send data; (3) test with non-sensitive or anonymized data to validate outputs and guardrails; (4) monitor any automated use if you enable autonomous invocation, and restrict permissions for any integrations (billing/policy scopes) to minimize blast radius.
Capability Analysis
Type: OpenClaw Skill Name: campaign-retrospective-analyst Version: 1.0.0 The skill bundle describes a business analysis task focused on advertising campaign retrospectives. All files, including the SKILL.md, are consistent with this stated purpose. There are no instructions for data exfiltration, malicious execution, persistence, or prompt injection attempts against the agent. In fact, SKILL.md includes explicit 'Constraints And Guardrails' that promote responsible AI behavior, such as 'Never fabricate metrics' and 'Separate observed facts from assumptions', and 'Failure Handling And Escalation' for 'high-risk issues'.
Capability Assessment
Purpose & Capability
The skill's name/description (retrospective analysis for multiple ad platforms) aligns with the instructions (query plan, trend deltas, recommendations). One minor note: the SKILL.md expects access to campaign data (data_source_scope) but does not document how data is obtained or any platform credentials — this is plausible (user-supplied exports) but should be understood before connecting live platform APIs.
Instruction Scope
Instructions stay on-task: disambiguate metrics, build query slices, summarize findings, propose actions, and include guardrails. There are no steps that instruct reading unrelated local files, accessing system credentials, or sending data to unknown endpoints.
Install Mechanism
No install specification and no code files are present. Because this is instruction-only, nothing is written to disk or fetched during install.
Credentials
The skill declares no required environment variables, credentials, or config paths. This is proportionate to an instruction-only analysis skill that expects the user to supply data or connector-config externally. If you plan to adapt it to fetch data from ad platforms, expect to add the appropriate, least-privilege credentials separately.
Persistence & Privilege
always is false and the skill is user-invocable. It does not request persistent presence or modify other skills or system settings. Autonomous invocation is allowed by platform default but is not accompanied by other elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install campaign-retrospective-analyst
  3. After installation, invoke the skill by name or use /campaign-retrospective-analyst
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial public release of campaign-retrospective-analyst - Supports retrospective analysis for ad campaigns on Meta, Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and DSP/programmatic platforms. - Specialized to deliver actionable insights: root-cause analysis, lesson extraction, and next-cycle design. - Provides a structured workflow with clear input/output contracts, decision rules, and confidence handling. - Includes platform-specific guidance and recommendations tailored to channel and campaign objectives. - Offers practical examples, code/query formats, and an operational quality checklist for reliability.
Metadata
Slug campaign-retrospective-analyst
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Ads Campaign Review?

Run retrospective analysis for campaigns on Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and DSP/programmatic channels. It is an AI Agent Skill for Claude Code / OpenClaw, with 322 downloads so far.

How do I install Ads Campaign Review?

Run "/install campaign-retrospective-analyst" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ads Campaign Review free?

Yes, Ads Campaign Review is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Ads Campaign Review support?

Ads Campaign Review is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ads Campaign Review?

It is built and maintained by danyangliu (@danyangliu-sandwichlab); the current version is v1.0.0.

💬 Comments