Guide · Agent skill
How to use the Market Sizing Analysis agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The market-sizing-analysis skill teaches an AI agent a structured method for estimating how large a market opportunity is, using TAM, SAM and SOM. It is written for founders preparing a pitch or business plan, and for students or analysts learning the framework. After following this guide you will know what the skill does, how to install it, how to ask for it in plain language, and what its limits are.
Market Sizing Analysiswshobson/agents · MIT Download the skill Quick start
- 1Download the ZIP. Get the market-sizing-analysis ZIP from this page.
- 2Unzip the skill. Unzip the archive so the market-sizing-analysis folder contains SKILL.md.
- 3Place the folder. Move it to ~/.claude/skills/ for personal use or to .claude/skills/ inside your project.
- 4Or upload it in the apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 5Make a request. Describe your product, customer and price in plain language and ask for TAM, SAM and SOM.
- 6Check the assumptions. Review each input and its source before using the numbers in a pitch or plan.
What is an agent skill and what does this one do?
An agent skill is a folder of instructions that an AI agent can load when a task matches it. This skill, named market-sizing-analysis, is built around SKILL.md, which describes when to use it and how to work through market sizing.
Once installed, the agent can calculate three tiers of market size. TAM (Total Addressable Market) is the total revenue available if you held 100% share. SAM (Serviceable Available Market) is the part your product can realistically serve given geography, segment or capability limits. SOM (Serviceable Obtainable Market) is the realistic share you could win in 3-5 years.
- Top-down: starts from industry research and narrows down to your segment.
- Bottom-up: builds from customer segments, counts and pricing.
- Value theory: estimates market size from the willingness to pay for solving the problem.
How do you install the market-sizing-analysis skill?
Download the ZIP for the skill from our page and unzip it. Then place the folder where your agent looks for skills. For a personal setup, use ~/.claude/skills/. For a single project, use the .claude/skills/ folder inside that project.
You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into .claude/skills/ in your project folder
- Claude apps: upload under Settings → Capabilities → Skills
How do you trigger the skill with a natural request?
You do not need a special command. The skill's description tells the agent to use it when you are sizing markets, estimating addressable revenue, validating a new venture's market opportunity, or building investor-ready market analysis for a pitch or business plan. Describe your goal in ordinary language and include the details you have.
Good requests name the product, the customer and the price if you know it. The more concrete your inputs, the more useful the output.
- Size the market for an AI email tool for Shopify stores and show TAM, SAM and SOM.
- Estimate addressable revenue for a B2B invoicing app for freelance designers, bottom-up.
- Is the market big enough for a new accounting tool for dental clinics? Give me a value theory estimate.
- Build an investor-ready market section for my business plan using top-down figures from industry reports.
What does a worked example look like?
The included example, examples/saas-market-sizing.md, works through AI-powered email marketing automation for e-commerce companies with $1M+ annual revenue in North America. It uses bottom-up analysis as the primary method and splits the target customers into segments with counts, average contract value (ACV) and priority.
The example is a model for structure. Your own numbers will differ, and you should replace the example's figures with your own sourced inputs.
- Segment criteria: target type, revenue band, geography and current tools.
- Segment table: revenue band, count, ACV and priority.
- Then TAM, SAM and SOM are derived from those segments.
Where should the inputs come from?
The references/data-sources.md file lists sources for market research, including premium research firms and more accessible research providers. The source notes that premium reports can be costly, with typical cost ranges given per firm, so check access before you plan around a paid report.
The skill itself gives a method. The figures depend on the inputs you supply, so label each assumption and where it came from.
- Premium research firms (for example Gartner, Forrester, IDC) list typical report costs in the source.
- McKinsey is listed as offering free insights and reports.
- Use the references/details.md file for detailed patterns and formulas.
TAM = Total Market Category Size
SAM = TAM × Geographic % × Segment %
SOM = SAM × Realistic Capture Rate (2-5%)What are the safety limits and requirements?
The skill lists no requirements. It does not run scripts and does not use the network. It is a set of instructions for reasoning about market size, so the agent works from the inputs you give it and from its own knowledge.
The skill is not a substitute for real market research. Unverified assumptions can produce misleadingly precise numbers, so do not rely on the output for major financial decisions. It is also not suited to regulated or high-stakes financial reporting that needs audited sources.
- Requires: nothing listed.
- Runs scripts: no.
- Uses network: no.
- Not for replacing real market research or audited financial reporting.
What tips improve the output?
Give the agent real counts and prices wherever you can, and ask it to show each assumption. Ask for a top-down and a bottom-up estimate and compare them. If they disagree widely, the gap usually tells you which input needs checking.
Keep SOM modest and explain it. The framework defines SOM as a realistic share achievable in 3-5 years, not a best-case figure.
- State your geography, segment and price in the request.
- Ask for the formula used at each step.
- Compare top-down and bottom-up results before using either.
- Check the sources in references/data-sources.md for your inputs.
What people use it for
- Sizing a new SaaS product for a specific customer segment before building a pitch deck.
- Estimating addressable revenue for a niche B2B tool using bottom-up segment counts and pricing.
- Validating whether a new venture's market is large enough to pursue.
- Learning the TAM/SAM/SOM framework as a student or analyst by working through the included example.
Frequently asked questions
How do I install the market-sizing-analysis skill?
Download the ZIP from this page and unzip it. Put the folder in ~/.claude/skills/ for personal use, or in .claude/skills/ inside a project. In the Claude apps you can instead upload it under Settings → Capabilities → Skills.
Does the market-sizing-analysis skill require anything else to run?
The skill lists no requirements. It does not run scripts and does not use the network, so it works by giving the agent a structured method.
Is the market-sizing-analysis skill free?
The skill is published under the MIT licence. This page does not list a price for the skill itself, and the source's cost figures refer to paid research reports, not to the skill.
What is the difference between TAM, SAM and SOM?
TAM is the total revenue if you held 100% of the market. SAM is the portion your product can serve given its geography, segment or capabilities. SOM is the realistic share you could win within 3-5 years.
Is top-down or bottom-up market sizing better?
Top-down suits mature markets with existing research. Bottom-up suits new or niche markets and is described as the more credible approach for investors. Running both and comparing them is a useful check.
Can I use this skill instead of paid market research?
No. The skill provides a method, and its output depends on the inputs you supply. For major financial decisions or audited reporting, use verified sources.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are a founder building a pitch or business plan, or a student learning TAM, SAM and SOM, and you can supply concrete inputs and sources. Pick a dedicated research service or an audited-data process instead if you need verified figures for major financial decisions or regulated reporting.
Download the skill