Skip to content

davepoon/buildwithclaude / plugins/venture-capital-intelligence/skills/market-size

market-size

Verified

FileKindSize
SKILL.mdskill md4.7 KB
scripts/market_formatter.pyscript3.4 KB
scripts/tam_calculator.pyscript5.3 KB

scripts/tam_calculator.py

View on GitHub
#!/usr/bin/env python3
"""
market-size/scripts/tam_calculator.py
Reads market_inputs.json, computes TAM/SAM/SOM using top-down and bottom-up.
Writes market_output.json.
"""

import json
import sys
import os


VENTURE_TAM_THRESHOLD = 1_000_000_000   # $1B
GOOD_CAGR_THRESHOLD   = 0.15            # 15%


def top_down_sizing(td: dict, arpu: float) -> dict:
    total_market = td.get("total_market_size_usd", 0)
    addr_frac    = td.get("addressable_fraction", 0.20)
    obt_frac     = td.get("obtainable_fraction", 0.05)
    cagr         = td.get("cagr_pct", 0) / 100.0

    tam = total_market
    sam = total_market * addr_frac
    som = sam * obt_frac

    # 5-year projections
    tam_5yr = tam * ((1 + cagr) ** 5)
    sam_5yr = sam * ((1 + cagr) ** 5)

    return {
        "method": "top-down",
        "tam": round(tam, 0),
        "sam": round(sam, 0),
        "som": round(som, 0),
        "tam_5yr": round(tam_5yr, 0),
        "sam_5yr": round(sam_5yr, 0),
        "cagr_pct": td.get("cagr_pct", 0),
        "source": td.get("source", "industry report"),
    }


def bottom_up_sizing(bu: dict) -> dict:
    total_customers    = bu.get("total_potential_customers", 0)
    addr_customers     = bu.get("addressable_customers", 0)
    obt_customers      = bu.get("obtainable_customers", 0)
    arpu               = bu.get("arpu_annual", 0)

    if addr_customers == 0 and total_customers > 0:
        addr_customers = int(total_customers * 0.20)
    if obt_customers == 0 and addr_customers > 0:
        obt_customers = int(addr_customers * 0.05)

    tam = total_customers * arpu
    sam = addr_customers * arpu
    som = obt_customers * arpu

    return {
        "method": "bottom-up",
        "tam": round(tam, 0),
        "sam": round(sam, 0),
        "som": round(som, 0),
        "total_potential_customers": total_customers,
        "addressable_customers":     addr_customers,
        "obtainable_customers":      obt_customers,
        "arpu_annual":               arpu,
    }


def consensus(td_result: dict, bu_result: dict) -> dict:
    td_tam = td_result.get("tam", 0)
    bu_tam = bu_result.get("tam", 0)
    td_sam = td_result.get("sam", 0)
    bu_sam = bu_result.get("sam", 0)
    td_som = td_result.get("som", 0)
    bu_som = bu_result.get("som", 0)

    valid_tams = [v for v in [td_tam, bu_tam] if v > 0]
    valid_sams = [v for v in [td_sam, bu_sam] if v > 0]
    valid_soms = [v for v in [td_som, bu_som] if v > 0]

    return {
        "tam_low":  round(min(valid_tams), 0) if valid_tams else 0,
        "tam_high": round(max(valid_tams), 0) if valid_tams else 0,
        "sam_low":  round(min(valid_sams), 0) if valid_sams else 0,
        "sam_high": round(max(valid_sams), 0) if valid_sams else 0,
        "som_low":  round(min(valid_soms), 0) if valid_soms else 0,
        "som_high": round(max(valid_soms), 0) if valid_soms else 0,
    }


def vc_rule_check(tam: float, cagr: float) -> list:
    flags = []
    if tam >= VENTURE_TAM_THRESHOLD:
        flags.append({"status": "PASS", "msg": f"TAM ${tam/1e9:.1f}B > $1B — venture-scale opportunity"})
    elif tam >= 500_000_000:
        flags.append({"status": "WATCH", "msg": f"TAM ${tam/1e9:.1f}B ($500M–$1B) — tight for top-tier VC"})
    else:
        flags.append({"status": "FAIL", "msg": f"TAM ${tam/1e6:.0f}M < $500M — likely too small for institutional VC"})

    if cagr >= GOOD_CAGR_THRESHOLD:
        flags.append({"status": "PASS", "msg": f"CAGR {cagr:.0%} — strong market tailwind"})
    elif cagr >= 0.05:
        flags.append({"status": "WATCH", "msg": f"CAGR {cagr:.0%} — moderate growth"})
    else:
        flags.append({"status": "FAIL", "msg": f"CAGR {cagr:.0%} — slow or flat market, headwind risk"})

    return flags


def main():
    script_dir = os.path.dirname(os.path.abspath(__file__))
    output_dir = os.path.join(script_dir, "..", "output")
    os.makedirs(output_dir, exist_ok=True)

    inputs_path = os.path.join(output_dir, "market_inputs.json")
    output_path = os.path.join(output_dir, "market_output.json")

    if not os.path.exists(inputs_path):
        print(f"ERROR: market_inputs.json not found at {inputs_path}", file=sys.stderr)
        sys.exit(1)

    with open(inputs_path, "r", encoding="utf-8") as f:
        inputs = json.load(f)

    arpu = inputs.get("price_per_customer_annual", 0)
    td   = inputs.get("top_down", {})
    bu   = inputs.get("bottom_up", {})

    if bu.get("arpu_annual", 0) == 0 and arpu > 0:
        bu["arpu_annual"] = arpu

    td_result  = top_down_sizing(td, arpu)
    bu_result  = bottom_up_sizing(bu)
    cons       = consensus(td_result, bu_result)
    cagr       = td.get("cagr_pct", 0) / 100.0
    flags      = vc_rule_check(cons["tam_high"], cagr)

    output = {
        "company":     inputs.get("company", "Unknown"),
        "market":      inputs.get("market_category", "Unknown"),
        "geography":   inputs.get("geography", "Global"),
        "top_down":    td_result,
        "bottom_up":   bu_result,
        "consensus":   cons,
        "vc_checks":   flags,
        "competitors": inputs.get("competitors", []),
    }

    with open(output_path, "w", encoding="utf-8") as f:
        json.dump(output, f, indent=2)

    tam = cons.get("tam_high", 0)
    print(f"tam_calculator.py: TAM=${tam/1e9:.1f}B, CAGR={cagr:.0%}")
    print(json.dumps(output, indent=2))


if __name__ == "__main__":
    main()
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall