1---2name: lead-value-math3description: >-4 Sets the most a B2B SaaS company can pay for a customer, a lead, an opportunity and a click, from its own deal size,5 win rates and spend rule (CAC share of ACV or payback months), then sets the smallest monthly budget a campaign6 needs to learn and how many campaigns a budget can carry. Returns HEADROOM, OVER CEILING, UNDERFUNDED, CEILING SET,7 NEEDS DECISION or BLOCKED with the rule that fired. Use it before setting bid targets, sizing a paid channel or8 judging cost per lead. Not for sorting search terms (use search-terms-triage) or splitting budget across channels9 (use channel-fit). Never uses a benchmark ratio or a borrowed cost per lead.10license: MIT11compatibility: >-12 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Uses a connected CRM or ad account if the13 agent has one, otherwise exports or pasted figures. Python 3 is optional, for the math.14metadata:15 author: SHAKEUP16 version: "1.0.0"17 stage: decide18 plugin: paid-media19 homepage: https://www.shakeuphq.com/skills/lead-value-math20---21 22# Lead value math23 24Turns deal size, win rates and the business's spend rule into the ceilings every paid campaign is held to.25 26## Purpose27 28- One job: compute allowable CAC, max cost per lead (max CPL), max cost per opportunity, max CPC, the campaign floor and the judgment window, and say whether the account sits under its ceilings.29- Stage: decide. It ends in a verdict.30- It never uses a benchmark ratio, an industry cost per lead or a "typical" win rate. Every input is the reader's.31- It never changes a bid, a target or a budget. It recommends; the reader applies.32 33## Use when / not34 35| Situation | Use |36| --- | --- |37| Setting or checking a Target CPA, a cost cap or a max CPC | this skill |38| Asking "what can we afford per lead?" on any paid channel | this skill |39| Deciding how many campaigns a budget can carry | this skill |40| Sorting search terms into keep, negative or new ad group | `search-terms-triage`, which reads this skill's `max_cpl` |41| Choosing which channels to fund at all | `channel-fit` |42| Planning LinkedIn layers and formats | `linkedin-plan`, after this skill |43| Reporting pipeline per channel | `pipeline-report` |44 45## Inputs46 47| Input | Required | Ways to provide, in order | If missing |48| --- | --- | --- | --- |49| ACV (average first-year contract value) | yes | `## Company` "Average deal size (ACV)"; a CRM closed-won report; the reader | ask once; then `BLOCKED` |50| Win rates: lead-to-won, or lead-to-opportunity and opportunity-to-won | yes | `## Targets`; a CRM report of paid leads over the trailing 12 months; the reader | ask once; then `BLOCKED` |51| Spend rule: CAC share of ACV, or payback months plus gross margin | yes (one) | `## Targets` lines "Target CAC share of ACV", "Target CAC payback", "Gross margin" if present; the P&L owner's answer | ask once, naming the P&L owner; then `BLOCKED`. Never default |52| Media share of CAC | no | the reader | if the spend rule is fully loaded CAC (salaries, tools), ask; otherwise treat it as media CAC and say so |53| Platform cost data: spend, clicks, leads (or CPC and conversion rate), with the period | no | a connected ad account; an export; pasted figures | ceilings only; verdict `CEILING SET` |54| Monthly non-brand budget for the channel | no | `## Channels`; the reader | floor computed, campaign count `not available` |55| Conversions a campaign needs a month to learn | no | Google Ads and Microsoft Ads: 30 (see step 6); any other platform: the reader or that platform's own documentation | floor `not available` for that platform |56| Sales cycle in days | no | `## Company` "Sales cycle" | judgment window `not available` |57| Are outcomes validated? (CRM stages reach the platform, or sales reviews leads monthly) | no | `## Accounts and data`; the reader | assume not validated and say so |58| Zero-conversion spend from a search terms run | no | `search-terms-triage` handoff `waste` | skip the recovered-pipeline estimate |59 60## Profile read61 62From `company-profile.md`: `## Company` (ACV, sales cycle, pricing, business model), `## Targets` (target cost per lead, lead to opportunity rate, opportunity to closed-won rate, pipeline target, and any spend-rule lines), `## Channels` (monthly budgets), `## Accounts and data` (CRM, connected ad accounts), and every `## Learnings` entry for `lead-value-math` with status `noted`, `fact` or `accepted`.63 64No profile: ask in one message for ACV, the 2 win rates (or lead-to-won), and the spend rule the P&L owner holds (share of ACV, or payback months and gross margin). Say that `company-profile` saves this next time.65 66## Steps67 681. **Apply learnings.** A `fact` (a new win rate, a new spend rule) replaces the profile value. An `accepted` proposal changes a rule below. Name each one that fires.69 702. **Normalize the inputs.** Same currency, rates as decimals, ACV as first-year value.71 72 | Check | Rule |73 | --- | --- |74 | Only monthly price known | ACV = monthly price x 12 only after the reader confirms; label it `estimate` |75 | Win rates for all sources, not paid | Use them, label `blended rate`, coverage `partial` (paid leads usually close at a different rate) |76 | Rates from less than one full sales cycle of closed deals | Label `immature cohort`: late deals haven't closed yet, so the rate reads low |77 | A rate above 100% or at 0 | Reject it and ask again |78 | Cost data period | Spend, clicks and leads from the same campaigns and the same dates |79 803. **Allowable CAC.**81 82 | Route | Formula | Use when |83 | --- | --- | --- |84 | Share | ACV x CAC share | The P&L owner states a share of contract value |85 | Payback | payback months x (ACV / 12) x gross margin | The P&L owner states a payback target |86 | Both given | the lower of the 2 | Always: the stricter limit is the one the business holds the channel to. Show both |87 | Fully loaded target | CAC x media share | The target covers salaries and tools, not only media |88 894. **Ceilings.**90 - Lead-to-won = lead-to-opportunity x opportunity-to-won, unless the reader gives lead-to-won directly.91 - Max CPL = allowable CAC x lead-to-won.92 - Max cost per opportunity = allowable CAC x opportunity-to-won.93 - Operating target:94 95 | Outcomes | Operating target | Why |96 | --- | --- | --- |97 | Validated (CRM stages reach the platform, or sales reviews leads monthly) | max CPL | The ceiling is measured on real buyers |98 | Not validated | 60% to 70% of max CPL | The margin absorbs lead quality nobody has checked |99 1005. **Compare with what the account pays.**101 - Actual CPL = spend / leads; without leads, CPC / conversion rate.102 - Headroom = max CPL minus actual CPL, also as a share of max CPL.103 - Max CPC = max CPL x conversion rate. Break-even conversion rate = CPC / max CPL.104 - For a list of keywords or campaigns, score each row: it pays when CPC / its conversion rate is under max CPL. A row with no conversions is judged on spend against max CPL, not on a rate.105 - Not validated and actual CPL above the operating band: recommend holding bids even when under the ceiling, because the headroom rests on unchecked leads.106 1076. **Campaign floor.** Floor = (conversions needed a month / conversion rate) x CPC. Campaigns the budget carries = non-brand budget / floor, rounded down.108 109 | Platform | Conversions needed a month | Source |110 | --- | --- | --- |111 | Google Ads (smart bidding) | 30 | Google recommends judging smart bidding over periods with at least 30 conversions (About Smart Bidding) |112 | Microsoft Ads (Max Conversions, Target CPA) | 30 | Microsoft says both stop optimizing below 30 conversions in any 30-day period (Budget and bid strategies, checked 2026-10-24) |113 | Any other platform | the reader's figure, or the platform's documented one opened in this run | otherwise `not available` |114 115 The conversion rate here is to the event bidding optimizes for, not to closed-won. Brand campaigns sit outside the count: separating brand protects measurement, not learning.116 Budget below one floor: list the 4 moves in order. Merge into an adjacent campaign that shares the target; move the optimization event to a mid-funnel action with more volume; Maximize Conversions with no target; manual CPC.117 1187. **Judgment window.** 1.5 x the sales cycle in days, rounded up: the time before a campaign can be read on pipeline. Search-term relevance, conversion rate and CPL read within 2 weeks; cost per opportunity, deal size and win rate need the full window.119 1208. **Recovered value (optional).** With a waste figure: recovered leads = waste / actual CPL; recovered pipeline = recovered leads x lead-to-won x ACV. Label it `estimate`: it assumes the moved budget converts at today's rate.121 1229. **Run the math.** `python3 scripts/lead_math.py` with the inputs (flags in its docstring; `--validated` when outcomes are validated; `--platform google` or `microsoft` for the floor; `--rows file.csv` to score keywords). Without Python, apply steps 3 to 8 by hand, show each formula with its figures, and say you ran it by hand.123 124## Check and verdict125 126| Verdict | Condition (first match wins) |127| --- | --- |128| `BLOCKED` | ACV, the win rates or a spend rule is missing after one question |129| `NEEDS DECISION` | The profile's "Target cost per lead" is above the computed max CPL: the business's own target is unaffordable by its own rule |130| `OVER CEILING` | Actual CPL, or actual cost per opportunity, is at or above its ceiling |131| `UNDERFUNDED` | The channel's non-brand budget is below one campaign floor |132| `CEILING SET` | Ceilings computed; no cost data to compare against |133| `HEADROOM` | Actual cost under the ceiling and the budget clears at least one floor |134 135`OVER CEILING` lists the levers in order: the click price (negatives, qualifiers, match types), then the page (conversion rate), then lead quality (what you bid for). Raising the CAC share also raises the ceiling, but that is a finance decision, not a fix.136 137Named stops: `BLOCKED` asks for the missing input once, naming who owns it. `NEEDS DECISION` shows the profile target beside the computed ceiling, with the inputs behind each, and asks which the P&L owner holds. No other stops.138 139## Learn140 141Append to `## Learnings` in the profile when:142 143- the P&L owner states or changes the spend rule: a `fact` (and propose adding it to `## Targets`);144- a quarter's CRM data moves a win rate: a `fact` with the report and date;145- after the judgment window, actual cost per opportunity comes back above or below the ceiling the plan set: a `fact`;146- the reader overrides the verdict (for example keeps spending over the ceiling for a strategic account list): a `proposal` with their reason.147 148Example: `- 2026-10-24 | lead-value-math | fact | Paid CAC may be up to 30% of first-year ACV | Why: CFO, budget review 2026-10-20 | Status: noted`149 150## Output151 152```153Verdict: <HEADROOM | OVER CEILING | UNDERFUNDED | CEILING SET | NEEDS DECISION | BLOCKED> · Coverage: <complete | partial (what's weak) | blocked> · Math: <script | by hand>154Rule that fired: <one line>155 156| Figure | Value | Formula and inputs |157| Allowable CAC | ... | <route>, <inputs and their source> |158| Lead-to-won | ... | ... |159| Max CPL | ... | ... |160| Max cost per opportunity | ... | ... |161| Operating target | ... | <validated or not> |162| Actual CPL | ... | <period, source> |163| Max CPC / break-even rate | ... | ... |164| Campaign floor | ... | <conversions needed and its source> |165| Campaigns the budget carries | ... | ... |166| Judgment window | ... days | 1.5 x <sales cycle> |167(every figure with its source, or "not available" and what would provide it)168 169Rows: <keyword or campaign table with pays or loses, if given>170What to do: <2 to 4 lines, levers in order; recommendations only>171Learnings applied: <list, or none>172```173 174Then the handoff block.175 176## Hand off177 178```handoff179skill: lead-value-math180version: 1.0.0181verdict: HEADROOM182coverage: partial (outcomes not validated)183for: <account or channel>184outputs:185 allowable_cac: 7200186 max_cpl: 285.12187 max_cost_per_opportunity: 1584188 operating_target: 171 to 200189 campaign_floor: 6000190 campaigns_supported: 2191 judgment_window_days: 93192 currency: USD193next: [search-terms-triage, linkedin-plan, microsoft-ads-b2b]194open: [validate outcomes before raising bids]195```196 197`search-terms-triage` uses `max_cpl` as its spend threshold. `linkedin-plan`, `microsoft-ads-b2b`, `reddit-plan` and `chatgpt-ads-check` hold their plans to `max_cpl`.198 199## Failure modes200 201| Problem | Do this |202| --- | --- |203| The reader asks for "a normal B2B ratio" or a benchmark CPL | Refuse the benchmark; ask who owns the P&L and what share or payback they hold. `BLOCKED` until answered |204| Platform conversions and CRM leads disagree by more than 15% | Use CRM leads for actual CPL and say so; the platform count is not describing real leads |205| Only one blended win rate exists | Use it, label it, coverage `partial`; propose a paid-only CRM report |206| The cost data mixes brand and non-brand | Ask for non-brand separately; brand converts at a different rate and hides the real CPL |207| The reader gives ACV as monthly recurring revenue | Ask; never multiply by 12 without confirmation |208| Conversion rate is 0 | Floor and max CPC are `not available`; judge spend against max CPL instead |209 210## Influenced by211 212- SHAKEUP's B2B Google Ads playbook: allowable CAC from a spend rule the P&L owner states, max CPL from the lead-to-won rate, the campaign floor and the judgment window of 1.5 sales cycles.213- Google's About Smart Bidding, for the 30-conversion reading period: https://support.google.com/google-ads/answer/7065882?hl=en214- Microsoft Advertising's budget and bid strategies guide, for the 30-conversion floor on automated bidding: https://learn.microsoft.com/en-us/advertising/guides/budget-bid-strategies?view=bingads-13