PluginBench
Skill
Pass
Audit score 90

ads-budget

agricidaniel/claude-ads

Plan and optimize paid-media budgets, bidding, and allocation across platforms with ROAS, CPA, and marginal-return analysis.

What is ads-budget?

Structures budget planning for paid advertising by establishing objectives, normalizing spend data, calculating break-even boundaries, and comparing allocation options. Use this when deciding how much to spend on ads, where to allocate budget across platforms, whether to scale campaigns, or how to set bidding strategies.

  • Calculate break-even boundaries and show formulas, inputs, uncertainty, and sensitivity cases
  • Distinguish committed baseline, controlled experiments, and reserve capacity
  • Compare hold, reallocate, scale, reduce, or experiment options using marginal evidence
  • Analyze metrics: CPA, ROAS, MER, LTV:CAC, spend pacing, and forecasts
  • Return decision-complete plans with platform/campaign amounts, timing, owners, guardrails, and rollback triggers
  • Normalize spend and outcomes across comparable windows and platform definitions

How to install ads-budget

npx skills add https://github.com/agricidaniel/claude-ads --skill ads-budget
Claude Code
Cursor
Windsurf
Cline

How to use ads-budget

  1. 1.Define your objective, target conversion value, gross margin, cash constraints, and sales capacity
  2. 2.Gather historical spend and outcome data (conversions, revenue) from each platform
  3. 3.Normalize data to comparable time windows and conversion definitions across platforms
  4. 4.Calculate break-even CPA and ROAS thresholds using the provided formulas
  5. 5.Identify your committed baseline, experimental budget, and reserve capacity
  6. 6.Compare allocation options (hold, reallocate, scale, reduce, experiment) using marginal returns, not blended averages
  7. 7.Document the final plan with platform amounts, timing, owner, guardrails, success measures, and rollback triggers

Use cases

Good for
  • Allocate quarterly ad budget across Google Ads, Meta, and TikTok based on historical ROAS and margin constraints
  • Decide whether to scale a high-performing campaign or hold spend pending more conversion data
  • Set bidding strategy and daily spend pacing to hit a target CPA while respecting cash flow limits
  • Evaluate tradeoffs between baseline spend, controlled experiments, and reserve capacity for new channels
  • Forecast ad spend and revenue under different seasonality and sales-capacity scenarios
Who it's for
  • Performance marketers and growth managers
  • E-commerce and SaaS finance teams
  • Product managers evaluating marketing ROI
  • Agencies managing multi-platform campaigns

ads-budget FAQ

Should I use fixed rules like 70/20/10 or fixed CPA multiples?

No. The skill treats these as optional heuristics, never universal authorization. Always base decisions on your specific margins, constraints, attribution uncertainty, and marginal evidence.

How do I handle attribution uncertainty across platforms?

Establish it upfront as a constraint in step 1. Normalize outcomes to comparable definitions, calculate sensitivity cases, and reserve capacity for experiments to reduce uncertainty over time.

What's the difference between marginal and blended returns?

Blended returns average all spend; marginal returns measure the incremental outcome of the next dollar spent. Use marginal evidence to decide scaling, not blended averages alone.

When should I use controlled experiments vs. scaling existing campaigns?

Use controlled experiments to test new channels or strategies with reserve capacity. Scale only after you have sufficient evidence (platform minimum evidence threshold) that marginal returns exceed break-even.

What should trigger a rollback?

Define rollback triggers upfront in your plan—e.g., CPA exceeds 1.5× target, ROAS drops below 3:1, or conversion volume falls below expected range. Monitor guardrails weekly.

Full instructions (SKILL.md)

Source of truth, from agricidaniel/claude-ads.


name: ads-budget description: "Plan and review paid-media budgets, bidding, pacing, marginal return, forecasts, CPA, ROAS, MER, LTV:CAC, constraints, and allocation across supported platforms. Use for ad budget allocation, media budget, bidding strategy, scaling, spend pacing, budget forecast, ROAS target, or investment tradeoffs."

Budget and Bidding

  1. Establish objective, conversion value, gross margin, cash constraints, sales capacity, attribution uncertainty, seasonality, and platform minimum evidence.
  2. Normalize spend and outcomes to comparable windows and definitions.
  3. Calculate break-even boundaries and show formulas, inputs, uncertainty, and sensitivity cases.
  4. Distinguish committed baseline, controlled experiments, and reserve capacity.
  5. Compare hold, reallocate, scale, reduce, or experiment options using marginal evidence rather than blended averages alone.
  6. Return a decision-complete plan with platform/campaign amount, timing, owner, guardrails, success measure, and rollback trigger.

Rules such as 70/20/10, fixed CPA multiples, fixed budget-to-CPA ratios, and fixed percentage scaling are optional heuristics, never universal authorization.