Hand over your current ad campaigns and spend numbers

Paid Media Optimization

by AgriciDaniel · MIT license · ★ 9,466 on GitHub · updated Sep 18

Hand over your current ad campaigns and spend numbers, get back a ranked list of what to change, pause, or test to stop wasting money.

---
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

Overview

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

Manual install (npx, ZIP)

Claude Codenpx skills add AgriciDaniel/claude-ads --skill ads-optimize -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/AgriciDaniel/claude-ads/tar.gz/ac2164493391 \
  | tar -xz -C ~/.claude/skills --strip-components=2 claude-ads-ac2164493391/skills/ads-optimize

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/4032b8a6fbd975ff6bfa/ads-optimize.zip" -OutFile "$env:TEMP\ads-optimize.zip"; Expand-Archive "$env:TEMP\ads-optimize.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md1.9 KB

Read the files here

AgriciDaniel/ac216441 file

SKILL.md1.9 KB

SKILL.md

Show the full text35 lines

ads-optimize/SKILL.md35 lines · 1.9 KB · ac21644

PreviewCode

Outline

RawView on GitHub

Paid Media Optimization

Default to --draft.

Load the latest normalized snapshot, prior decisions, monitoring results, experiment state, conversion lag, economics, and platform capability manifest.
Identify the decision and causal evidence; do not optimize a metric in isolation.
Compare no-change, experiment, and mutation options, including learning, policy, tracking, inventory, and opportunity-cost effects.
Produce ranked recommendations with confidence and success measures.
Convert approved recommendations into mutation plans only through the main mutation gate.
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.

1	---
2	name: ads-optimize
3	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."
4	---
5
6	# Paid Media Optimization
7
8	Default to `--draft`.
9
10	1. Load the latest normalized snapshot, prior decisions, monitoring results,
11	experiment state, conversion lag, economics, and platform capability manifest.
12	2. Identify the decision and causal evidence; do not optimize a metric in isolation.
13	3. Compare no-change, experiment, and mutation options, including learning, policy,
14	tracking, inventory, and opportunity-cost effects.
15	4. Produce ranked recommendations with confidence and success measures.
16	5. Convert approved recommendations into mutation plans only through the main
17	mutation gate.
18	6. Apply, verify, audit, and retain rollback only when the exact operation is
19	enabled and remote state still matches the draft precondition.
20
21	Never use a fixed CPA multiple, budget ratio, benchmark, or novelty claim as sole
22	authorization to change an account.
23
24	## Destructive-action boundary
25
26	Refuse permanent deletion of campaigns, ad groups, ads, audiences, conversions,
27	or other account objects. Permanent deletion is outside the supported mutation
28	contract and cannot be made safe by confirmation. Offer reversible alternatives:
29	leave objects paused, archive where supported, apply labels, export a backup, and
30	define a retention or later-review date. Do not create or apply a delete plan.
31
32	Search-term actions require a search terms report, business-relevance evidence,
33	and an overblocking review. Without them, request the missing evidence and do not
34	invent or illustrate specific negative keywords.
35