Agent skill · research science · alirezarezvani
market-research
Use for market sizing (TAM, SAM, SOM both top-down and bottom-up), survey sample sizes or segment scoring. Runs market_sizer.py, sample_size_planner.py and segmentation_scorer.py and never returns one unsourced number.
Why this skill is useful
Adds three executable scripts for market sizing, survey planning, and segmentation scoring that provide rigorous methodologies not commonly found in public resources.
What it needs
Requires python installed locally. About 5k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
market-research Upstream market-research methodology: market sizing, survey/sampling design, and segmentation. The discipline here is method + assumptions: a TAM is never a single number, a survey is never powered only in aggregate, and a segment is never a demographic slice. Purpose Market-research analysts, product marketers, and strategy teams need rigorous evidence before anyone optimizes a campaign or sets a strategy. This skill structures three methodology decisions: Three deterministic tools: 1. marketsizer.py — Computes TAM/SAM/SOM by both top-down and bottoms-up methods side-by-side, reports the divergence, and flags failed triangulation. Never returns a single number. 2. samplesizeplanner.py — Survey sample size from confidence, margin of error, and expected proportion, with the finite-population correction and per-segment minimums (a survey powered overall is not powered per reported segment). 3. segmentationscorer.py — Scores candidate segments against Kotler's five criteria and enforces a substantiality + accessibility gate; a slice that is too small or unreachable is dropped. When to use Invoke this skill when: A board or exec asks "how big is this market?" and you need a defensible, triangulated answer. You are fielding a survey and need a sample size that holds up per segment, not just overall. You have a list of candidate segments and need to know which are real markets vs demographic slices. You are synthesizing competitive intelligence and need a methodological backbone. Do NOT use this skill to: measure a live campaign (attribution, ROAS, CPA → marketing-skill/campaign-analytics), build demand-gen / paid-media plans (marketing-skill/marketing-demand-acquisition), set positioning / GTM strategy (marketing-skill/marketing-strategy-pmm), or set pricing (commercial/pricing-strategist). Workflow 1. Write the brief — Fill assets/marketresearchbrieftemplate.md (objective, the decision this informs, sizing approach, sampling plan, assumptions register). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/market-research--cc475e