# ads-optimization

The ads-optimization Claude Code skill reviews paid ad results and organizes creative tests. It activates for campaign audits, rising CPA, or questions about a drop in performance.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 249 repo stars
- Author: Aron Houyu
- License: CC-BY-NC-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aronhy/marketing-skill-hub/tree/HEAD/skills/ads-optimization/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ads-optimization

## What it does

The skill helps plan creative experiments and diagnose campaign results. It can work from screenshots, pasted tables, or CSV files. Its review uses metrics from the current and previous periods, store orders, campaign targets, and notes about recent changes.

Weekly and monthly reviews draw on `references/ads-review-optimization.md` and `references/weekly-review-example.md`. Creative tests use separate guidance and a log template. If `.agents/product-context.md` is present, the skill reads it first. Platform-specific settings require `paid-ads` and its reference for the relevant ad platform.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add aronhy/marketing-skill-hub
```
In the agent chat (not a shell):
```text
/plugin install marketing-skill-hub@aronhy-marketing
```
This installs the whole marketing-skill-hub plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add aronhy/marketing-skill-hub --skill ads-optimization -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/ads-optimization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ads-optimization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aronhy/marketing-skill-hub --skill ads-optimization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ads-optimization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aronhy/marketing-skill-hub --skill ads-optimization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ads-optimization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aronhy/marketing-skill-hub skills/ads-optimization
```

2. **Manually: put the files in place**
- File: `.github/skills/ads-optimization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aronhy/marketing-skill-hub --skill ads-optimization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aronhy/marketing-skill-hub --path skills/ads-optimization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ads-optimization/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aronhy/marketing-skill-hub/tree/HEAD/skills/ads-optimization/SKILL.md

## When to use it
- plan a test for ad creatives
- trace a CPA increase to a funnel stage
- compare platform metrics with store orders
- prepare a weekly campaign review

## Example prompts
- Find why CPA rose using this table and the store orders.
- Plan a test for these ad creatives.
- Review this week's campaigns from the screenshot.

## Similar
- [ads-math](https://affpapa.org/en/nevibecode/skills/ads-math.md) — skill · 4100 installs
- [layer-ua-creatives](https://affpapa.org/en/nevibecode/skills/layer-ua-creatives.md) — skill · 1100 installs
- [paid-measurement-loop](https://affpapa.org/en/nevibecode/skills/paid-measurement-loop.md) — skill · 1100 installs
- [ads-optimize](https://affpapa.org/en/nevibecode/skills/ads-optimize.md) — skill · 939 installs
- [Pinterest Ads](https://affpapa.org/en/nevibecode/mcp/pinterest-ads.md) — MCP server
- [thought-leadership-ads](https://affpapa.org/en/nevibecode/skills/thought-leadership-ads.md) — skill · 25800 installs

From the same set: [aronhy/marketing-skill-hub](https://affpapa.org/en/nevibecode/by/aronhy/marketing-skill-hub.md) — 11 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
