← Back to Skills Marketplace
danyangliu-sandwichlab

Ads Bid Optimizer

by danyangliu · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
361
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install budget-bidding-optimizer
Description
Optimize budget pacing and bid strategy for Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and DSP/programmatic auctions.
README (SKILL.md)

Ads Bid Optimizer

Purpose

Core mission:

  • bid logic, pacing guardrails, allocation optimization

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: bid logic, pacing guardrails, allocation optimization

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:

  • objective: growth target and KPI priority
  • budget_frame: test budget and scale budget
  • channel_scope: channels to include

Optional:

  • audience_segments
  • creative_inventory
  • seasonality_window
  • policy_constraints

Output Contract

  1. Strategy Snapshot
  2. Channel Role Definition
  3. Budget and Bidding Plan
  4. Test Matrix
  5. Scale and Kill Rules

Workflow

  1. Define objective hierarchy (primary and secondary KPI).
  2. Assign channel roles by funnel stage.
  3. Allocate budget by expected signal and risk.
  4. Design test cells and learning windows.
  5. Set scale, hold, and stop rules.

Decision Rules

  • If KPI conflict exists, prioritize revenue efficiency over volume.
  • If channel evidence is weak, allocate minimum test budget first.
  • If audience is broad, start with modular creatives and layered targeting.

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

Strategy Matrix (YAML)

objective: improve_roas
channels:
  - name: Meta
    role: demand_creation
  - name: Google Ads
    role: demand_capture
budget_split:
  Meta: 0.55
  Google Ads: 0.45

Test Cell Example

cell_id: T1
variable: audience_segment
success_metric: cpa

Examples

Example 1: Channel mix reset

Input:

  • Budget fixed at 50k
  • ROAS dropped for two weeks

Output focus:

  • reallocation plan
  • test matrix
  • stop-loss conditions

Example 2: Creator-led expansion strategy

Input:

  • Goal: scale traffic without ROAS collapse
  • Channels: TikTok Ads + YouTube Ads

Output focus:

  • funnel role split
  • budget pacing logic
  • creative cadence

Example 3: Retargeting-heavy recovery

Input:

  • Prospecting unstable
  • Strong existing customer base

Output focus:

  • retargeting architecture
  • audience exclusion design
  • two-phase launch 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 is an offline planning/advice template and appears internally consistent. Before you install or let an agent act on its recommendations: (1) understand this skill does not itself connect to ad accounts — any execution will require separate credentials and integration code, so avoid providing API keys or account credentials to the skill unless you intentionally wire it to a trusted connector; (2) clarify what the vendor/skill does with any "handoff payloads" if you later add an execution layer — require explicit endpoints and consent; (3) if you plan to let the agent run autonomously and execute changes in ad accounts, restrict that to a limited test account and audit all actions; (4) validate suggested strategies against your platform policies and legal/privacy requirements (PII, ad policy, billing); and (5) if you want stronger guarantees, prefer a skill that declares the exact integration method and required environment variables so you can review them before granting access.
Capability Analysis
Type: OpenClaw Skill Name: budget-bidding-optimizer Version: 1.0.0 The skill bundle, consisting of `_meta.json`, `SKILL.md`, and `metadata.json`, is consistently aligned with its stated purpose of optimizing ad budgets and bid strategies. The `SKILL.md` file provides clear instructions, workflow, and guardrails for an AI agent, explicitly promoting ethical behavior (e.g., 'Never fabricate metrics'). There are no indications of prompt injection attempts, data exfiltration, malicious execution, persistence mechanisms, or any other harmful intent. The instructions are purely declarative and guide the agent's reasoning process for ad optimization.
Capability Assessment
Purpose & Capability
Name/description match the content of SKILL.md: it describes bid logic, pacing guardrails, allocation optimization across ad platforms and the inputs/outputs and workflow are aligned with that purpose. There are no unexpected requirements (no env vars, no binaries, no platform credentials) that would be incoherent for a planning/advisory skill.
Instruction Scope
SKILL.md contains only guidance for producing strategy output, test matrices, and guardrails. It does not instruct reading system files, environment variables, or contacting external endpoints. One ambiguous phrase — "escalate with a structured handoff payload" — mentions creating a handoff payload but does not specify any endpoint or exfiltration mechanism; this is vague but not demonstrably malicious given the rest of the content.
Install Mechanism
No install spec and no code files — instruction-only skill. This is the lowest-risk install footprint and nothing is written to disk or downloaded.
Credentials
The skill declares no required environment variables, credentials, or config paths. That is proportionate for an advisory/strategy skill which does not connect to ad accounts or execute account-level actions.
Persistence & Privilege
always is false and the skill does not request permanent presence or system modification. Model invocation is allowed (default) which is normal for skills; there are no additional elevated privileges requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install budget-bidding-optimizer
  3. After installation, invoke the skill by name or use /budget-bidding-optimizer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of budget-bidding-optimizer skill. - Provides actionable budget pacing and bid strategy optimization for Meta, Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and DSP/programmatic platforms. - Includes defined input/output contracts to ensure operational clarity. - Outlines a workflow for KPI hierarchy, channel roles, budget allocation, testing, and scaling decisions. - Adds platform-specific recommendations and clear decision rules for common advertising scenarios. - Features failure and risk handling procedures, practical examples, and a structured quality checklist.
Metadata
Slug budget-bidding-optimizer
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Ads Bid Optimizer?

Optimize budget pacing and bid strategy for Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and DSP/programmatic auctions. It is an AI Agent Skill for Claude Code / OpenClaw, with 361 downloads so far.

How do I install Ads Bid Optimizer?

Run "/install budget-bidding-optimizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ads Bid Optimizer free?

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

Which platforms does Ads Bid Optimizer support?

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

Who created Ads Bid Optimizer?

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

💬 Comments