Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
agricidaniel avatar

Ads Math

  • 2.3k installs
  • 7.6k repo stars
  • Updated July 13, 2026
  • agricidaniel/claude-ads

ads-math is a Claude Code skill at version 1.5 that runs PPC financial models including CPA, ROAS, break-even, and LTV:CAC analysis from pasted export data without requiring ad platform API access.

About

ads-math is a PPC financial calculator and modeling skill at version 1.5, tested 2026-05-17 with Claude Code v2.x, requiring zero API access and working from pasted export data. The skill computes CPA, ROAS, CPL, break-even analysis, impression share opportunity sizing, budget forecasting, LTV:CAC ratio analysis, and MER assessment. Developers reach for ads-math when evaluating paid search economics during campaign planning or budget reviews without opening spreadsheets or connecting Google Ads APIs. Trigger phrases include PPC math, ad calculator, break-even, budget forecast, ROAS calculator, CPA calculator, impression share, LTV CAC, and MER.

  • Performs 8 core PPC calculations including CPA, ROAS, CPL, break-even, impression share, LTV:CAC, MER and budget forecas
  • Zero API access required - works entirely with pasted CSV exports or verbal descriptions
  • Shows every formula transparently then interprets results against industry benchmarks
  • Flags concerning metrics and delivers actionable recommendations
  • Detects calculation intent from natural language triggers like 'ROAS calculator' or 'break-even'

Ads Math by the numbers

  • 2,314 all-time installs (skills.sh)
  • +508 installs in the week ending Jul 28, 2026 (Skillselion tracking)
  • Ranked #219 of 3,301 Productivity & Planning skills by installs in the Skillselion catalog
  • Security screen: LOW risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
npx skills add https://github.com/agricidaniel/claude-ads --skill ads-math

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs2.3k
repo stars7.6k
Security audit3 / 3 scanners passed
Last updatedJuly 13, 2026
Repositoryagricidaniel/claude-ads

How do you calculate PPC ROAS and break-even without spreadsheets?

Instantly run accurate PPC financial models and ad performance forecasts without spreadsheets or external tools.

Who is it for?

Developers and growth engineers who paste Google Ads or PPC export data and need instant financial modeling without spreadsheets or API keys.

Skip if: Developers who need live campaign automation, ad creative generation, or backend service deployment instead of financial calculations.

When should I use this skill?

The user asks for PPC math, ROAS or CPA calculations, break-even analysis, budget forecasts, impression share sizing, LTV:CAC, or MER from pasted data.

What you get

CPA and ROAS calculations, break-even reports, budget forecasts, impression share sizing, and LTV:CAC ratio assessments.

  • ROAS and CPA calculations
  • Break-even analysis
  • Budget forecast models

By the numbers

  • Version 1.5 released 2026-04-13
  • Tested 2026-05-17 with Claude Code v2.x
  • Requires zero API access for all calculations

Files

SKILL.mdMarkdownGitHub ↗

PPC Financial Calculator & Modeling

<!-- Created: 2026-04-13 | v1.5 --> <!-- Source: itallstartedwithaidea/google-ads-skills (PPC math concept) -->

Process

1. Ask the user what calculation they need (or detect from context) 2. Collect required inputs (from pasted data, exports, or verbal description) 3. Perform calculations with clear formulas shown 4. Present results with interpretation and recommendations 5. Flag any concerning metrics or benchmarks

Calculators

1. CPA Calculator

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)

2. ROAS Calculator

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

3. Break-Even Analysis

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

4. Impression Share Opportunity

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

5. Budget Forecasting

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)

6. LTV:CAC Ratio

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

7. MER (Marketing Efficiency 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

Incrementality & Advanced Measurement

For advanced accounts evaluating cross-channel contribution:

  • Meta Incremental Attribution (launched April 2025): AI-powered holdout testing measuring real causal impact. Evaluate if budget exceeds $5K/month.
  • Google Meridian (2025): Open-source Marketing Mix Model for incrementality measurement across channels.
  • These tools complement PPC math calculations by measuring what would NOT have happened without the ad spend.

For large accounts detecting small effects (5% MDE), multiply the 10% MDE sample by ~4x.

Quick Formulas Reference

MetricFormula
CPASpend / Conversions
ROASRevenue / Spend
CTRClicks / Impressions × 100
CVRConversions / Clicks × 100
CPCSpend / Clicks
CPM(Spend / Impressions) × 1,000
CPLSpend / Leads
Break-Even CPAAOV × Margin%
Break-Even ROAS1 / Margin%
LTVARPU × Avg Lifespan
CACTotal Marketing / New Customers
MERTotal Revenue / Total Marketing
Impression Share OppRevenue × (1/IS - 1)

Output Format

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

Data to Request

If the user doesn't provide enough data, ask for:

  • Platform and campaign type
  • Time period for analysis
  • Spend and conversion data
  • Revenue data (if ROAS/break-even needed)
  • Margin data (if break-even/LTV needed)
  • Business type (for benchmark comparison)

Related skills

How it compares

Choose this over spreadsheet templates when you need instant PPC financial models inside an agent session from pasted export rows.

FAQ

Does ads-math require Google Ads API access?

ads-math requires zero API access and works with pasted data from PPC exports. The skill at version 1.5 handles CPA, ROAS, break-even, budget forecasting, and LTV:CAC calculations entirely offline from supplied numbers.

What financial metrics does ads-math compute?

ads-math computes CPA, ROAS, CPL, break-even analysis, impression share opportunity sizing, budget forecasting, LTV:CAC ratio analysis, and MER assessment. Developers invoke it with phrases like PPC math, ROAS calculator, or break-even.

Is Ads Math safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Productivity & Planningfinancepricingecommerce

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.