Market Research

Market Research is a methodology skill for upstream market research: it sizes markets as TAM/SAM/SOM using both top-down and bottoms-up approaches, plans survey sample sizes with finite-population correction and per-segment minimums, and scores candidate segments against Kotler's five criteria. It produces evidence packs where every number carries its method, assumptions, and confidence.

✨ What it does

  • Computes TAM/SAM/SOM by both top-down and bottoms-up methods and flags divergence.
  • Plans survey sample size with finite-population correction and per-segment minimums.
  • Scores segments against Kotler's measurable/substantial/accessible/differentiable/actionable criteria and enforces a sub
  • Includes an onboarding questionnaire that customizes tool behavior (profile, confidence, margin of error, sizing method)
  • Offers an opt-in autoresearch bridge to iteratively reconcile top-down and bottoms-up sizing.
  • Provides a forcing-question library for rigorous methodology review.

🎯 When to use it

  • When asked 'how big is this market?' and you need a defensible, triangulated answer.
  • When fielding a survey and need a sample size that holds up per segment, not just overall.
  • When you have candidate segments and need to know which are real markets vs demographic slices.
  • When synthesizing competitive intelligence and need a methodological backbone.

🚀 How to use

Trigger: /ar:setup

Trigger by asking for market sizing, survey sample planning, or segment scoring. Provide inputs as JSON files (market.json, survey.json, segments.json) or use the sample data. Run the scripts with Python. Example prompts:

Run the market sizer on my market.json with the b2b-saas profile.
Plan a survey sample for a population of 62,000 with 95% confidence and 5% margin of error.
Score my segments.json against Kotler criteria.

📄 Output: An evidence pack combining market sizing, survey plan, and segment scores, with each number showing its method and assumptions.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/research-ops/skills/market-research .claude/skills/market-research

Skill source: research-ops/skills/market-research/SKILL.md

⚠️ Good to know

The tools cannot validate your inputs; they enforce methodology but rely on the quality of the data you provide.

❓ FAQ

Does the market sizer return a single TAM number?

No, it always computes TAM/SAM/SOM both top-down and bottoms-up and reports the divergence, never a single unsourced number.

What happens if a segment fails the substantiality or accessibility gate?

The segmentation scorer drops that segment automatically.

How do I customize the skill's defaults?

Run the onboarding questionnaire once with python3 scripts/onboard.py; answers are saved to a config file and read automatically.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.