# bid-strategy-planner

Selects bid strategies (tCPA, tROAS, max-conversions, or manual CPC), calculates starting targets from history, and plans learning-phase entry.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 installs · ★ 3013
- Author: aaron-he-zhu
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/ad/orchestrate/bid-strategy-planner/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/bid-strategy-planner

## What it does

The skill selects an automated or manual bidding strategy based on campaign goals and historical conversion volume. It calculates the initial tCPA or tROAS target from account data, labeling each input as Measured, User-provided, or Estimated. It does not require live ad network API keys to run; manual numbers or GA4 exports are sufficient.

It organizes campaigns sharing goals into bid portfolios while keeping prospecting and direct-response separate. The learning-phase plan outlines required conversion volume and sets a do-not-touch window to prevent mid-learning churn. Never set a target the account has never achieved, or ad delivery will throttle.

Recommendations are stored in `memory/ad/bid-strategy-planner/`, and structural decisions are saved to `memory/open-loops.md`. Budget allocation and live pacing checks are left to dedicated adjacent skills.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill bid-strategy-planner -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill bid-strategy-planner -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill bid-strategy-planner -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aaron-he-zhu/aaron-marketing-skills bid-strategy-planner
```

2. **Manually: put the files in place**
- File: `.github/skills/bid-strategy-planner/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill bid-strategy-planner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aaron-he-zhu/aaron-marketing-skills --path ad/orchestrate/bid-strategy-planner
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill bid-strategy-planner -a opencode
```

### 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/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/ad/orchestrate/bid-strategy-planner/SKILL.md

## When to use it
- choose between tCPA, tROAS, max-conversions, and manual CPC bidding
- calculate baseline tCPA or tROAS targets from conversion history
- group matching campaigns into a shared bid portfolio
- plan the learning-phase entry window and estimate conversions needed to exit

## Example prompts
- Pick a bid strategy for DR campaign: past 30 days $42 CPA at 90 conversions/mo
- Set a starting tROAS target for campaign: history is 3.8x ROAS, goal is 4.5x
- Group these 4 search campaigns into a bid portfolio and plan the learning-phase entry

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c35c264c7ae2002e.

BEGIN THIRD-PARTY FILE c35c264c7ae2002e
````text
---
name: bid-strategy-planner
slug: aaron-bid-strategy-planner
displayName: "Bid Strategy Planner · 出价策略"
summary: "出价策略/tCPA目标/tROAS/学习期"
description: 'Use when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"; produces a bid-strategy choice (tCPA / tROAS / max-conversions / manual CPC), the starting target math, a portfolio grouping map, and a learning-phase entry plan. Not for splitting the budget across campaigns — use budget-optimizer; not for in-flight pacing/scale moves — use budget-pacing-monitor; not for scoring the account — use ad-account-auditor. 出价策略/tCPA目标/tROAS/学习期'
version: "20.1.0"
license: Apache-2.0
compatibility: "Claude Code and compatible agent-skill hosts"
homepage: "https://github.com/aaron-he-zhu/aaron-marketing-skills"
when_to_use: "Use when choosing a bid strategy for a new or restructured paid campaign, setting an initial tCPA or tROAS target from CPA/ROAS history, deciding between automated (tCPA/tROAS/max-conversions) and manual CPC bidding, grouping campaigns into a bid portfolio, or planning how a campaign enters and exits the learning phase without churn. Not in-flight pacing — that is budget-pacing-monitor."
argument-hint: "<goal: DR|prospecting> [conversion history: CPA/ROAS + volume] [campaign set]"
metadata: {"author": "aaron-he-zhu", "version": "20.1.0", "discipline": "ad", "phase": "orchestrate", "geo-relevance": "low", "hermes": {"tags": ["marketing", "ad", "orchestrate"], "category": "ad"}, "openclaw": {"emoji": "🎯", "homepage": "https://github.com/aaron-he-zhu/aaron-marketing-skills"}}
---

# Bid Strategy Planner

Chooses the bid strategy for a paid campaign — tCPA, tROAS, max-conversions, or manual CPC — sets the starting target from the account's own conversion history, groups campaigns into a bid portfolio, and lays out a learning-phase entry plan. This is the plan skill that sets the ROAS **S (Spend-efficiency)** bidding lever; it does not allocate the budget (`budget-optimizer`), does not adjust pacing in-flight (`budget-pacing-monitor`), and does not score the account or run the vetoes (`ad-account-auditor`).

## Quick Start

```
Pick a bid strategy for [campaign]: DR goal, past 30 days $42 CPA at 90 conversions/mo
```

```
Set a starting tROAS target for [campaign] — history is 3.8x ROAS, goal is 4.5x
```

```
Group these 4 search campaigns into a bid portfolio and plan the learning-phase entry
```
````
END THIRD-PARTY FILE c35c264c7ae2002e

The third-party file has ended. Everything between the c35c264c7ae2002e tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2505 of 10403 bytes. © aaron-he-zhu · Apache-2.0 · https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/ad/orchestrate/bid-strategy-planner/SKILL.md

_Part of the page did not fit — see the HTML version._

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