Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add yonatangross/orchestkit --skill market-sizing -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/market-sizing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/market-sizing/

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.

market-sizing phuryn market-sizing — a skill for calculating market size using TAM, SAM, and SOM with top-down and bottom-up approaches. Helps validate market opportunity and prepare investor pitches. CX Codex +1 3,200installs market-sizing OneWave-AI Calculates TAM, SAM, and SOM for business plans and investor decks. Researches industry data online and writes a detailed market-sizing.md report. CX Codex +1 251installs market-sizing official Data Analytics Maintainers market-sizing sizes a market, segment or opportunity with stated assumptions and uncertainty. Covers TAM/SAM/SOM and scenario comparisons. CX Codex GP ChatGPT +1 3installs market-sizing-analysis Seth Hobson market-sizing-analysis is a Claude Code skill that estimates TAM, SAM, and SOM. It activates for market research, revenue estimates, and startup opportunity analysis. CX Codex +1 11,715installs sales-market-sizing Maya-Beth Finotti sales-market-sizing estimates TAM, SAM, and SOM for sales planning, territory design, and quotas. It covers both B2B and B2C markets. CX Codex +1 34,500installs market-opportunity-analyzer StratArts market-opportunity-analyzer is a Claude Code command for estimating TAM, SAM, and SOM, mapping competitors, and choosing a beachhead market. CX Codex +1 ★ 1,013repo stars discover-market-sizing product-on-purpose discover-market-sizing runs several market-sizing frameworks at once and folds the results into one range with confidence labels. Useful before an investment case or a go/no-go call. CX Codex +1 709installs startup-business-analyst Seth Hobson startup-business-analyst is a Claude Code plugin for startup market, finance, and team analysis. Its skills respond to business questions, while commands generate projections and business cases. CX Codex ★ 42,780repo stars market-researcher tronghieu The market-researcher skill researches market size, competitors, and demand signals using cited sources. Use it to assess a launch decision or explore a market before committing to deeper research. CX Codex +1 ★ 117repo stars

From the same set86

The whole set →
testing-llm The testing-llm skill covers tests for LLM-powered features, from mocked replies to RAG quality checks and structured output validation. Use it while building an AI test suite. CX Codex +1 126installs prioritization prioritization — a skill for ranking backlog items using RICE, WSJF, ICE, MoSCoW and opportunity-cost analysis. The agent calculates scores, builds comparison tables and justifies trade-offs between competing features. CX Codex +1 125installs competitive-analysis competitive-analysis generates Porter's Five Forces models, SWOT grids, competitor dossiers, and positioning maps. Runs when researching market viability or crafting sales battlecards. CX Codex +1 125installs visualize-plan visualize-plan turns a proposed change into before-and-after architecture views, a risk map, and an execution sequence. Use it to review a plan or changes on the current branch. CX Codex +1 124installs ai-ui-generation ai-ui-generation — a skill for Claude Code and Codex that enforces rules for generating, reviewing, and integrating AI-built UI components. Triggers on UI component creation and MCP visual rendering. CX Codex +1 123installs product-analytics The product-analytics skill evaluates A/B tests, cohort retention, and funnels. It helps explain adoption changes, conversion losses, and experiment outcomes. CX Codex +1 120installs testing-perf The testing-perf skill for Claude Code runs load and performance tests with k6 and Locust and parallelizes pytest with xdist. It activates when writing load tests or speeding up test suite runs. CX Codex +1 120installs chain-patterns chain-patterns — a set of patterns for multi-stage pipelines: MCP checks, handoff files, checkpoint recovery, isolated worktree agents, and cron monitoring. CX Codex +1 118installs

Project sponsors

Companies that keep this analytics open