configs/skills/ads-math/SKILL.md
PPC financial calculator and modeling tool. CPA, ROAS, CPL calculations, break-even analysis, impression share opportunity sizing, budget forecasting, LTV:CAC ratio analysis, and MER (Marketing Efficiency Ratio) assessment. Requires zero API access. Works with pasted data from exports. Use when user says PPC math, ad calculator, break-even, budget forecast, ROAS calculator, CPA calculator, impression share, LTV CAC, or MER.
npx skillsauth add shenxingy/claude-code-kit ads-mathInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
CPA = Total Spend / Total Conversions
Inputs needed:
- Total ad spend (period)
- Total conversions (same period)
Output:
- CPA with period context
- CPA trend (if historical data provided)
- Comparison to industry benchmark (from benchmarks.md)
ROAS = Revenue from Ads / Ad Spend
ROAS% = (Revenue - Spend) / Spend × 100
Inputs needed:
- Total ad spend
- Total revenue attributed to ads
Output:
- ROAS as ratio (e.g., 3.5x) and percentage (250%)
- Break-even ROAS (based on margins if provided)
- Comparison to platform benchmarks
Break-Even CPA = Average Order Value × Profit Margin
Break-Even ROAS = 1 / Profit Margin
Inputs needed:
- Average order value (AOV) OR average deal value
- Profit margin (gross margin %)
- Current CPA or ROAS
Output:
- Maximum profitable CPA
- Minimum profitable ROAS
- Current headroom (how far above/below break-even)
- Recommendation: scale, maintain, or cut
Impression Share Lost (Budget) = opportunity from budget increase
Impression Share Lost (Rank) = opportunity from bid/quality improvement
Revenue Opportunity = Current Revenue × (1 / Current IS - 1)
Inputs needed:
- Current impression share %
- IS lost to budget %
- IS lost to rank %
- Current spend and conversions
Output:
- Estimated additional conversions from full IS
- Budget needed for full IS (estimated)
- Priority: budget increase vs quality improvement
Projected Spend = Daily Budget × Days in Period
Projected Conversions = Projected Spend / Historical CPA
Projected Revenue = Projected Conversions × AOV
Scaling scenarios:
- Conservative: +20% budget → estimated impact
- Moderate: +50% budget → estimated impact
- Aggressive: +100% budget → estimated impact (with diminishing returns caveat)
Inputs needed:
- Current daily budget
- Historical CPA (last 30 days)
- Forecast period
- AOV (if revenue projection needed)
Output:
- 3 scenarios with spend, conversions, revenue projections
- Diminishing returns warning for aggressive scaling
- 20% scaling rule reminder (never increase >20% at a time)
CAC = Total Marketing Spend / New Customers Acquired
LTV = Average Revenue per Customer × Average Customer Lifespan
LTV:CAC Ratio = LTV / CAC
Inputs needed:
- Total marketing spend (all channels)
- New customers acquired
- Average revenue per customer (monthly or annual)
- Average customer lifespan (months)
- Optional: gross margin for unit economics
Output:
- LTV:CAC ratio with interpretation:
- <1:1 = losing money on every customer
- 1:1-2:1 = break-even to marginal
- 3:1 = healthy (SaaS benchmark)
- 5:1+ = may be under-investing in growth
- Payback period: months to recover CAC
- Recommendation based on ratio
MER = Total Revenue / Total Marketing Spend
Inputs needed:
- Total business revenue (period)
- Total marketing spend across ALL channels (same period)
Output:
- MER ratio (e.g., 5.0x)
- Interpretation:
- E-commerce: 3-5x typical, 8x+ excellent
- SaaS: 5-10x typical (higher margins)
- Local service: 3-8x typical
- Comparison to business-type benchmark
- Note: MER captures blended efficiency including organic, brand, and retention
For advanced accounts evaluating cross-channel contribution:
For large accounts detecting small effects (5% MDE), multiply the 10% MDE sample by ~4x.
| Metric | Formula | |--------|---------| | CPA | Spend / Conversions | | ROAS | Revenue / Spend | | CTR | Clicks / Impressions × 100 | | CVR | Conversions / Clicks × 100 | | CPC | Spend / Clicks | | CPM | (Spend / Impressions) × 1,000 | | CPL | Spend / Leads | | Break-Even CPA | AOV × Margin% | | Break-Even ROAS | 1 / Margin% | | LTV | ARPU × Avg Lifespan | | CAC | Total Marketing / New Customers | | MER | Total Revenue / Total Marketing | | Impression Share Opp | Revenue × (1/IS - 1) |
## PPC Financial Analysis
### [Calculator Name]
**Inputs:**
- [Listed inputs with values]
**Results:**
| Metric | Value | Benchmark | Status |
|--------|-------|-----------|--------|
| [Metric] | [Value] | [Benchmark] | PASS/WARNING/FAIL |
**Interpretation:**
[1-2 sentence analysis]
**Recommendation:**
[Actionable next step]
If the user doesn't provide enough data, ask for:
testing
Test-suite diet — consolidate near-identical tests into table-driven cases, delete trivial/mock-only/brittle tests, and report every piece of coverage intentionally given up. Counterweight to AI test bloat that erodes loop clock speed.
development
In-session iterative loop — keeps Claude running in the current session until a task is done. Unlike /loop (which spawns background workers), /iloop stays in the current session and re-prompts each iteration via Stop hook. Use for: 'keep fixing until tests pass', 'iterate until this feature works', autonomous debugging. Triggers on: '/iloop', 'in-session loop', 'keep iterating', 'loop until done'.
development
Compose high-converting emails using proven copy frameworks (PAS, AIDA, BAB, FAB, 4Ps). Generates subject line variants with scores, responsive HTML templates with dark mode support, plain-text fallback, and preheader recommendations. Optimized for cold outreach, newsletters, product launches, promotions, and transactional emails. Adapts to user context from email-profile.md.
tools
Designs complete email automation sequences with timing, subject lines, copy, and conditional logic. Supports welcome series, nurture campaigns, re-engagement, abandoned cart, post-purchase, review requests, and custom sequences. Adapts sequence type, cadence, frameworks, and conditional branching to business context. Use when user wants to create an automated email series triggered by subscriber actions or time intervals.