
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-mathAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 2.3k |
|---|---|
| repo stars | ★ 7.6k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 13, 2026 |
| Repository | agricidaniel/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
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 benchmarks3. 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 cut4. 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 improvement5. 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 ratio7. 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 retentionIncrementality & 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
| 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) |
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.