Agent skill

Market Research

by shawnpang in shawnpang/startup-founder-skills

When the user needs to estimate market size, understand market dynamics, or validate that a market opportunity is large enough to pursue.

MITAuto-check passedMarketing & SEO

Install Market Research

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill market-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills market-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/market-research .claude/skills/market-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
market-research
GitHub stars
343
Token cost
~1.9k tokens
SKILL.md length
1,014 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user needs to estimate market size, understand market dynamics, or validate that a market opportunity is large enough to pursue.

  • Works in 7 steps: Define market boundaries -- Specify the… → Top-down estimation -- Start from total… → Bottom-up estimation -- Build… → …
  • Needs to estimate market size
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Market Research is an agent skill from shawnpang/startup-founder-skills. When the user needs to estimate market size, understand market dynamics, or validate that a market opportunity is large enough to pursue.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Market research, Startup and business strategy and Market sizing. The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Needs to estimate market size
  • Understand market dynamics
  • Validate that a market opportunity is large enough to pursue

Example prompts

  • “/market-research”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Define market boundaries -- Specify the problem space, customer segments, geography, and constraints. "Project management tools" is a…
  2. Top-down estimation -- Start from total industry size using industry reports, public company revenues, and government statistics. Narrow…
  3. Bottom-up estimation -- Build independently from unit economics: (number of potential customers) x (price per customer) x (purchase…
  4. Scope the SAM -- Identify which portion of TAM is realistically serviceable given current product capabilities, pricing, distribution…
  5. Estimate the SOM -- Project achievable market share in 1-3 years based on competitive position, go-to-market capacity, and current traction.
  6. Project growth -- Forecast how TAM, SAM, and SOM evolve over 2-3 years. Identify key growth drivers, technology shifts, regulatory…
  7. Map assumptions -- Surface every critical assumption underlying each estimate. Rate confidence levels and identify how to validate the…

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Market Research loads about 1.9k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 1,014 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 1,014 words, ~1,939 tokens.

Download SKILL.mdSave it as .claude/skills/market-research/SKILL.md (or your agent's skills folder).
name
market-research
description
When the user needs to estimate market size, understand market dynamics, or validate that a market opportunity is large enough to pursue.
related
competitive-analysis, prd-writing
reads
startup-context

Market Research

When to Use

Activate when a founder needs to size a market opportunity using TAM/SAM/SOM, validate market assumptions for a pitch deck, understand growth trends, evaluate market entry, or prepare for investor conversations about addressable market. Trigger phrases include "how big is our market," "TAM/SAM/SOM," "market size," "market opportunity," "is this market big enough," "market trends," "help me with the market slide," or "validate our market assumptions."

Context Required

  • From startup-context: product description, target customer segments, pricing model, geographic scope, business model.
  • From the user: the market or segment to analyze, known data points (industry reports, customer counts, pricing benchmarks), geographic and industry constraints, whether this is for internal decision-making or external presentation (investor deck), and any specific hypotheses about market dynamics.

Workflow

  1. Define market boundaries -- Specify the problem space, customer segments, geography, and constraints. "Project management tools" is a different market than "team collaboration software." Precision determines whether the analysis is useful.
  2. Top-down estimation -- Start from total industry size using industry reports, public company revenues, and government statistics. Narrow to the relevant segment by applying filters for geography, customer type, and product category.
  3. Bottom-up estimation -- Build independently from unit economics: (number of potential customers) x (price per customer) x (purchase frequency). Cross-validate against the top-down estimate.
  4. Scope the SAM -- Identify which portion of TAM is realistically serviceable given current product capabilities, pricing, distribution channels, and geographic reach.
  5. Estimate the SOM -- Project achievable market share in 1-3 years based on competitive position, go-to-market capacity, and current traction.
  6. Project growth -- Forecast how TAM, SAM, and SOM evolve over 2-3 years. Identify key growth drivers, technology shifts, regulatory changes, and demographic trends.
  7. Map assumptions -- Surface every critical assumption underlying each estimate. Rate confidence levels and identify how to validate the most uncertain assumptions.

Output Format

Market Definition

One paragraph defining the problem space, customer need, geographic and segment boundaries, and key scoping decisions.

TAM / SAM / SOM
MetricCurrent Estimate2-3 Year ProjectionMethodConfidence
TAM$X$YTop-down + Bottom-upHigh/Med/Low
SAM$X$YFiltered from TAMHigh/Med/Low
SOM$X$YPenetration modelHigh/Med/Low
Sizing Methodology

Top-Down: Step-by-step calculation from industry totals to target segment. Show every filter and assumption applied.

Bottom-Up: Step-by-step calculation from unit economics up. Show: (number of target customers) x (expected conversion rate) x (annual contract value).

Reconciliation: Comparison of both approaches, explanation of any gaps, and reconciled estimate. If they diverge by more than 3x, investigate the assumptions driving the gap.

Key factors that could expand or contract the market -- technology shifts, regulatory changes, demographic trends, behavioral changes, and emerging adjacent segments.

Key Assumptions & Risks
AssumptionImpact if WrongConfidenceValidation Method
DescriptionWhat changes in the estimateHigh/Med/LowHow to test this
Strategic Implications

Numbered list of what the market data means for product, pricing, and go-to-market decisions.

Show full SKILL.md (541 more words)Show less

Frameworks & Best Practices

  • Always do both top-down and bottom-up. Top-down is fast but abstract. Bottom-up is precise but assumption-heavy. The truth is where they converge. Providing both triangulates and builds credibility with investors.
  • Beware vanity TAMs. "The global software market is $500B" is not useful. Define the market narrowly enough that you can name the buyer persona, their budget line item, and what they pay today.
  • The "who writes the check" test. Market size should be based on the actual budget your product replaces or claims. A $50/month tool's market is (number of buyers) x ($600/year), not the total revenue of the industry you serve.
  • Growth rate matters more than current size. A $500M market growing 40% annually is more attractive than a $5B market growing 3%. Investors and founders should optimize for tailwinds.
  • Distinguish value-based from volume-based sizing. Revenue-based (dollars) and volume-based (users/units) tell different stories. Be explicit about which you are using and why.
  • Assumption sensitivity analysis. Identify the 2-3 assumptions that most affect your estimate. Show what happens if each is 50% lower. If the market is still attractive at the pessimistic end, the thesis is robust.
  • Source hierarchy for credibility: (1) Government statistics and census data, (2) Public company filings and earnings calls, (3) Industry association reports, (4) Analyst reports (Gartner, Forrester, IDC), (5) Startup databases (PitchBook, Crunchbase), (6) Your own primary research and customer data.
  • Cite sources for market data. Avoid unsupported numbers. Label what is an estimate vs. what is sourced data. Flag where estimates have wide confidence intervals.
  • Geographic specificity. Global TAMs are meaningful only if you plan to sell globally from day one. Start with the geography and segment you will actually target first.
  • Adjacent market expansion. After sizing the core market, identify 1-2 adjacent markets you could expand into. This shows a growth path beyond the initial wedge.
  • Consider currency and purchasing power parity for international market sizing.
  • competitive-analysis -- Pair market sizing with competitive landscape analysis to understand both the size of the prize and how contested it is.
  • prd-writing -- Use market segment data to ground the Market Segments section of a PRD in real numbers.
  • roadmap-planning -- Use growth trend analysis to time roadmap investments. Build for fast-growing segments first.

Examples

Example 1: Market sizing for a pitch deck

User: "Help me size the market for our developer productivity tool. We need the TAM/SAM/SOM for our Series A deck."

Good output excerpt:

TAM: $[X]B -- Global developer tools market (source: [industry report], includes IDEs, testing, CI/CD, monitoring, and productivity tools).

SAM: $4.2B -- Code review and collaboration segment, filtered to teams of 10-500 developers at companies with >$5M revenue in North America and Europe.

SOM: $85M -- 2% penetration of SAM over 4 years, based on current growth rate of 15% QoQ and average ACV of $18K.

Bottom-up cross-check: 23,000 target companies x 12% expected conversion at maturity x $18K ACV = $49.7M.

Example 2: New segment validation

User: "We're thinking about expanding from SMB to mid-market. Is that market big enough?"

Good output should size the mid-market segment separately, compare unit economics (higher ACV but longer sales cycle), estimate the investment required to serve the segment (enterprise features, sales team), and calculate whether the segment-level SOM justifies the investment within the planning horizon.

© shawnpang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/market-research of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

Market Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Market Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Market Research this skillshawnpang/startup-founder-skills343—~1.9kAutomated safety check: PassMIT
Startup Designferdinandobons/startup-skill1.2k—~8.1kAutomated safety check: PassMIT
Market Research Analysismanojbajaj95/claude-gtm-plugin105—~2.6kAutomated safety check: PassMIT
Market Researchthatrebeccarae/claude-marketing161—~1.1kAutomated safety check: PassMIT
Market ResearcherNeverSight/learn-skills.dev2171 repos~2.1kAutomated safety check: PassNone
Market AnalyzerMathews-Tom/armory329—~2.4kAutomated safety check: PassMIT

Similar skills

  • Startup Design

    ferdinandobons/startup-skill

    Design, validate, and plan a startup from scratch. An agent skill from ferdinandobons/startup-skill.

    1.2k GitHub stars~8.1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Market Research Analysis

    manojbajaj95/claude-gtm-plugin

    Comprehensive market research and analysis skill. An agent skill from manojbajaj95/claude-gtm-plugin.

    105 GitHub stars~2.6k tokensUpdated 23 days ago
    Marketing & SEOAuto-check passed
  • Market Research

    thatrebeccarae/claude-marketing

    Generate comprehensive market research reports (50+ pages) in the style of top consulting firms (McKinsey, BCG, Gartner).

    161 GitHub stars~1.1k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Market Researcher

    NeverSight/learn-skills.dev

    Market research specialist focused on comprehensive market analysis, consumer behavior insights, and market opportunity identification.

    217 GitHub starsUsed in 1 repo~2.1k tokens
    Marketing & SEOAuto-check passed
  • Market Analyzer

    Mathews-Tom/armory

    Structured market analysis with TAM/SAM/SOM sizing, trends, and competitive landscape via WebSearch, producing investor-grade cited reports.

    329 GitHub stars~2.4k tokensUpdated 5 days ago
    Product & Project ManagementAuto-check passed
  • Startup Validator

    ailabs-393/ai-labs-claude-skills

    Comprehensive startup idea validation and market analysis tool.

    455 GitHub starsUsed in 1 repo~2.8k tokens
    Marketing & SEOAuto-check passed

More from shawnpang/startup-founder-skills

All 50 skills in this repo
  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    343 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    343 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Churn Analysis

    shawnpang/startup-founder-skills

    When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    343 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    343 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed

Questions about Market Research

What does Market Research do?

When the user needs to estimate market size, understand market dynamics, or validate that a market opportunity is large enough to pursue. Market Research is an agent skill from shawnpang/startup-founder-skills. When the user needs to estimate market size, understand market dynamics, or validate that a market opportunity is large enough to pursue.

When should I use Market Research?

Market Research fits situations like: needs to estimate market size; understand market dynamics; validate that a market opportunity is large enough to pursue.

How do I install Market Research in Claude Code?

Run `npx skills add shawnpang/startup-founder-skills --skill market-research -a claude-code`. Or copy the skill folder (skills/market-research in shawnpang/startup-founder-skills) into .claude/skills/market-research in your project. Claude Code loads it when a task matches its description.

How do I install Market Research in Codex?

Run `npx skills add shawnpang/startup-founder-skills --skill market-research -a codex`. Or copy the skill folder (skills/market-research in shawnpang/startup-founder-skills) into .agents/skills/market-research in your project. Codex loads it when a task matches its description.

Can I use Market Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shawnpang/startup-founder-skills --skill market-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/market-research, .gemini/skills/market-research, .github/skills/market-research and .opencode/skills/market-research in your project.

What does Market Research need to run?

SKILL.md names no scripts, command-line tools or credentials: Market Research is instructions for the agent only.

Does Market Research access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Market Research safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Market Research use?

Market Research is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Market Research use?

About 1.9k tokens (SKILL.md is roughly 7.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Market Research?

Skills that share tags, products or a category with Market Research: Startup Design (ferdinandobons/startup-skill, 1.2k stars), Market Research Analysis (manojbajaj95/claude-gtm-plugin, 105 stars), Market Research (thatrebeccarae/claude-marketing, 161 stars) and Market Researcher (NeverSight/learn-skills.dev, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Market Research?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 343 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.