Skip to main content
skill CX Codex

ads-optimize — Claude Code skill: what it does, how to install

Reviews paid-ad data, drafts changes, and applies them only after conditions are checked. Use it for budgets, bids, CPA, ROAS, and search-term decisions.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AgriciDaniel/claude-ads --skill ads-optimize -a claude-code
Open on GitHub

What ads-optimize does

The skill loads the latest normalized snapshot, prior decisions, monitoring results, experiment state, conversion lag, economics, and the platform capability manifest. It then compares no change, an experiment, and a campaign mutation while accounting for learning, policy, tracking, inventory, and opportunity cost.

It defaults to --draft and produces ranked recommendations with confidence and success measures. Approved recommendations pass through the main mutation gate; an action is applied only when that operation is enabled and remote state still matches the draft precondition. This means the underlying account data deserves a check before changes go live.

The skill refuses permanent deletion of campaigns, ad groups, ads, audiences, conversions, and other account objects. It can instead suggest pausing, archiving, labels, a backup, or a later review date. Search-term actions require a search terms report, business-relevance evidence, and an overblocking review.

What it helps with

  • reallocate campaign budget from available evidence
  • compare an experiment with a bid change
  • prepare a reversible pause plan for ads
  • review search terms before negative-keyword action
  • verify conditions before applying account mutations

Example prompts for the agent

  • Prepare --draft recommendations to improve campaign CPA and ROAS.
  • Compare no change, an experiment, and a budget mutation for the current campaign data.
  • Review the search terms report and propose action only where the required evidence is present.

How to install ads-optimize

1Skills CLI (Vercel)

npx skills add AgriciDaniel/claude-ads --skill ads-optimize -a claude-code

2Manually: put the files in place

~/.claude/skills/ads-optimize/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ads-optimize/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ads-optimize

How do I install ads-optimize in Claude Code?

Run npx skills add AgriciDaniel/claude-ads --skill ads-optimize -a claude-code, then run npx skills add AgriciDaniel/claude-ads --skill ads-optimize -a claude-code again. The skill file is at ~/.claude/skills/ads-optimize/SKILL.md.

What does ads-optimize do?

It reviews campaign evidence and creates ranked recommendations for budgets, bids, experiments, and related actions. It uses --draft by default rather than applying changes immediately.

Can ads-optimize permanently delete a campaign?

No. Permanent deletion is outside its mutation contract; it suggests reversible options such as pausing or archiving instead.

Source text

SKILL.md · MIT
---
name: ads-optimize
description: "Diagnose and draft or explicitly apply paid-ad optimizations using evidence, financial constraints, experiments, and capability-gated adapters. Use for campaign optimization, budget reallocation, bid changes, pausing or archiving ads, requests to delete campaigns, search-term or negative-keyword actions, creative rotation, or improving CPA and ROAS."
---

# Paid Media Optimization

Default to `--draft`.

1. Load the latest normalized snapshot, prior decisions, monitoring results,
   experiment state, conversion lag, economics, and platform capability manifest.
2. Identify the decision and causal evidence; do not optimize a metric in isolation.
3. Compare no-change, experiment, and mutation options, including learning, policy,
   tracking, inventory, and opportunity-cost effects.
4. Produce ranked recommendations with confidence and success measures.
5. Convert approved recommendations into mutation plans only through the main
   mutation gate.
6. Apply, verify, audit, and retain rollback only when the exact operation is
   enabled and remote state still matches the draft precondition.

Never use a fixed CPA multiple, budget ratio, benchmark, or novelty claim as sole
authorization to change an account.

## Destructive-action boundary

Refuse permanent deletion of campaigns, ad groups, ads, audiences, conversions,
or other account objects. Permanent deletion is outside the supported mutation
contract and cannot be made safe by confirmation. Offer reversible alternatives:
leave objects paused, archive where supported, apply labels, export a backup, and
define a retention or later-review date. Do not create or apply a delete plan.

Search-term actions require a search terms report, business-relevance evidence,
and an overblocking review. Without them, request the missing evidence and do not
invent or illustrate specific negative keywords.

© AgriciDaniel · MIT · AgriciDaniel/claude-ads

Similar skills

Everything for Marketing and content →

From the same set32

ads-test Walks a paid-media experiment from hypothesis to readout: randomization unit, sample size, stopping rule, and a plain-language decision. CX Codex +1 3,600installs ads-attribution Audits advertising attribution across platforms and blocks totals built from incompatible conversion reports. Use it when GA4, MMP, or platform figures disagree. CX Codex +1 3,400installs ads-amazon Audits Amazon Ads profiles and campaign signals, from targeting to ACOS and TACOS. Use it when reviewing account structure, reporting, and proposed campaign changes. CX Codex +1 3,300installs ads-server-side-tracking Audits server-side paid-media measurement: verifies event parameters between browser and server, checks deduplication, data hashing, and privacy compliance. Spots conversion loss and bugs in sGTM, Meta CAPI, TikTok Events API. CX Codex +1 3,300installs ads-report Renders Markdown, HTML or PDF reports on paid advertising from a validated JSON run bundle. Useful when a client or an exec needs a finished document. CX Codex +1 645installs ads-monitor Monitors paid advertising delivery, budget pacing, creative fatigue, and tracking health. Runs read-only anomaly checks across multiple data snapshots. CX Codex +1 633installs ads-launch Builds a plan for launching a paid ad campaign and applies it only after explicit approval. Draft mode is the default. CX Codex +1 610installs ads-research This skill refreshes stale evidence about ad platforms, APIs, policies and benchmarks. Useful when a refresh_due date has passed and repo claims no longer hold. CX Codex +1 601installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor