market-sizing · yonatangross — Claude Code skill: TAM/SAM/SOM and how to install
market-sizing is a Claude Code skill that calculates TAM, SAM and SOM using top-down and bottom-up methods, then cross-validates them. It runs when sizing a market or preparing pitch slides.
MIT 124 installs ★ 305 updated 2026-11-07
npx skills add yonatangross/orchestkit --skill market-sizing -a claude-codeWhat market-sizing does
Skill builds a three-tier addressable market model: total market (TAM), reachable segment (SAM) and realistic share in three years (SOM). Computes top-down from industry data and bottom-up from sales capacity, requires methods to align within 20%. Applies constraints to SOM — sales team capacity, go-to-market reach, competitive pressure — to avoid inflated forecasts.
Input is customer data, average deal size, number of competitors. Skill reads project files via Read, searches by pattern with Glob and Grep, fetches recent reports via WebFetch and WebSearch. Output is a table with three metrics, calculation formulas and confidence level for each number. Sources older than two years are flagged low confidence.
What it helps with
- estimate market size for a startup or new product
- prepare TAM/SAM/SOM slides for an investor pitch deck
- cross-validate top-down calculation with bottom-up and spot gaps
- factor in sales constraints and competition when forecasting SOM
- pull current market data through web search
Example prompts for the agent
- Calculate TAM, SAM and SOM for an AI code review tool in the enterprise segment
- Build a market model with top-down and bottom-up, data is in
market-data.md - Check divergence between methods and adjust SOM for sales capacity limits
How to install market-sizing
1Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill market-sizing -a claude-code2Manually: put the files in place
~/.claude/skills/market-sizing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/market-sizing/
1Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill market-sizing -a codex2Manually: put the files in place
.agents/skills/market-sizing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill market-sizing -a cursor2Manually: put the files in place
.cursor/skills/market-sizing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install yonatangross/orchestkit src/skills/market-sizing2Manually: put the files in place
.github/skills/market-sizing/SKILL.md1Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill market-sizing -a gemini-cli2Platform CLI
gemini skills install https://github.com/yonatangross/orchestkit --path src/skills/market-sizingManually: put the files in place
.devin/skills/market-sizing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill market-sizing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about market-sizing
How to install market-sizing in Claude Code?
Run npx skills add yonatangross/orchestkit --skill market-sizing -a claude-code, the skill will land in ~/.claude/skills/market-sizing/SKILL.md.
What does market-sizing skill do?
Calculates TAM, SAM and SOM using two methods — top-down from market volume and bottom-up from actual sales — and cross-validates them. Applies constraints to SOM so the forecast reflects sales team capacity and competition.
What data is required for the calculation?
Number of potential customers, average deal size, segment share of total market, sales capacity, number of competitors. Skill pulls industry reports via WebFetch and WebSearch when available.
Source text
SKILL.md · MIT
--- name: market-sizing compatibility: "Claude Code 2.1.277+" description: "TAM, SAM and SOM with top-down and bottom-up estimates and cross-checked assumptions. Use when sizing a market or preparing pitch market slides." user-invocable: false disable-model-invocation: false metadata: owner-agent: "product-strategist" category: document-asset-creation version: "1.0.0" author: "OrchestKit" complexity: "medium" tags: "tam, sam, som, market-size, addressable-market, opportunity-sizing" allowed-tools: "Read Glob Grep WebFetch WebSearch" --- # Market Sizing TAM/SAM/SOM framework for estimating addressable market and validating opportunity size. ## Definitions | Metric | Definition | Question It Answers | |--------|------------|---------------------| | **TAM** | Total Addressable Market — everyone who could possibly buy | "What's the theoretical ceiling?" | | **SAM** | Serviceable Addressable Market — segment you can actually reach | "What can we realistically target?" | | **SOM** | Serviceable Obtainable Market — realistic share in 3 years | "What will we actually capture?" | ``` +-------------------------------------------------------+ | TAM | | +---------------------------------------------------+ | | | SAM | | | | +-----------------------------------------------+| | | | | SOM || | | | +-----------------------------------------------+| | | +---------------------------------------------------+ | +-------------------------------------------------------+ ``` ## When to Use Top-Down vs. Bottom-Up | Method | Use When | Risk | |--------|----------|------| | **Top-Down** | Industry reports exist; investor pitch; quick estimate | Overestimates SOM | | **Bottom-Up** | Sales capacity known; pricing validated; more credible | More work; requires assumptions | | **Both (recommended)** | High-stakes decisions; fundraising; board decks | Cross-validate to build confidence | Always cross-validate both methods and reconcile within 20%. If they diverge by more than that, revisit your assumptions. ## Quick Formulas ``` Top-Down TAM = (# potential customers) × (annual value per customer) SAM = TAM × (% your solution can address) SOM = SAM × (realistic market share % in 3 years) Bottom-Up SOM = (# customers you can acquire) × (average deal size) SAM = SOM / (your expected market share %) TAM = SAM / (your segment as % of total market) ``` ## Example: AI Code Review Tool ```markdown ## Market Sizing: AI Code Review Tool ### Top-Down TAM - Global developers: 28M - Using code review tools: 60% → 16.8M - Average annual spend: $300/developer - TAM = $5.04B SAM - Enterprise only (>500 employees): 8M developers - Willing to pay premium: 40% → 3.2M - SAM = $960M SOM - Sales capacity supports ~$15M ARR (Year 3) - Realistic market share: 2% - Unconstrained SOM = $960M × 2% = $19.2M - Constrained SOM = min($19.2M, $15M) = $15M ### Bottom-Up - Target accounts Year 1: 50 enterprise deals - Average ACV: $100K - Year 1 ARR: $5M - Year 3 (3× growth): $15M ARR → SOM = $15M ### Reconciled SOM: $15M (confirmed by both methods) ``` ## SOM Constraint Model Do not report an unconstrained SOM. Always apply real-world limits: ``` SOM constraints: Sales capacity: supports $15M ARR max Competitive pressure: 5 strong incumbents → −20% market share Go-to-market reach: 70% of SAM reachable with current channels Conservative SOM = min( SAM × target_share%, sales_capacity_ceiling, SAM × gtm_reach% × target_share% ) ``` ## Confidence Levels | Confidence | Evidence Required | |------------|------------------| | HIGH | Multiple corroborating sources, data < 2 years old | | MEDIUM | Single authoritative source, 1-2 years old | | LOW | Extrapolated, heavy assumptions, data > 2 years old | Always label each number with its confidence level in deliverables. ## Common Mistakes | Mistake | Correction | |---------|------------| | TAM = "everyone on earth" | Define a specific, bounded customer segment | | SOM = 10% of a billion-dollar market | Apply actual sales capacity and GTM constraints | | Single method only | Cross-validate top-down and bottom-up | | Old data | Use sources < 2 years old; flag if older | | Ignoring competition | SOM must account for incumbents' share | ## References - [TAM/SAM/SOM Rules](rules/market-tam-sam-som.md) — Calculation methods, SOM constraint model, cross-referencing - [TAM/SAM/SOM Guide](references/tam-sam-som-guide.md) — Detailed guide with data source recommendations ## Related Skills - `ork:competitive-analysis` — Understand competitive dynamics that constrain SOM - `ork:business-case` — Build financial justification once opportunity is sized - `ork:product-frameworks` — Full product strategy toolkit --- Version: 1.0.0
© OrchestKit · MIT · yonatangross/orchestkit
Similar skills
All skills for Finance and business →market-sizing by other authors comes first.