Agent skill

Market Research

by borghei in borghei/Claude-Skills

Market sizing and market structure work — TAM/SAM/SOM built top-down and bottom-up then reconciled, segmentation, demand triangulation, and survey design.

MITAuto-check passedProduct & Project Management

Install Market Research

skills CLI
$ npx skills add borghei/Claude-Skills --skill market-research -a claude-code

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

GitHub CLI
$ gh skill install borghei/Claude-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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/research-ops/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
891
Token cost
~2.8k tokens
SKILL.md length
1,439 words
Files
10 (incl. scripts, references, assets)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Market sizing and market structure work — TAM/SAM/SOM built top-down and bottom-up then reconciled, segmentation, demand triangulation, and survey design.

  • Works in 5 steps: Write the market definition sentence… → Build the top-down chain: published… → Build the bottom-up chain independently:… → …
  • Sizing a market
  • SKILL.md covers When to use this skill, Inputs the skill expects, Clarify First and Workflows, plus 3 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Market Research is an agent skill from borghei/Claude-Skills. Market sizing and market structure work — TAM/SAM/SOM built top-down and bottom-up then reconciled, segmentation, demand triangulation, and survey design. Use when sizing a market, writing a sizing memo, or fielding a survey.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts, reference files and assets (for example `assets/market-sizing-memo-template.md`, `assets/sample_demand_signals.json` and `assets/sample_market_model.json`).

It sits in Product & Project Management, covering Market sizing and Market research. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Sizing a market
  • Writing a sizing memo
  • Fielding a survey

Example prompts

  • “/market-research”

Requirements

  • Python 3

Workflow steps

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

  1. Write the market definition sentence first. Everything downstream inherits it.
  2. Build the top-down chain: published market value, then named filters that
  3. Build the bottom-up chain independently: unit count from a countable source,
  4. Run the builder. It computes both chains, reconciles them layer by layer, and
  5. Resolve every fail before the number leaves your machine. A warn needs a

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. 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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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 2.8k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 1,439 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 1,439 words, ~2,787 tokens.

Download SKILL.mdSave it as .claude/skills/market-research/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
market-research
description
Market sizing and market structure work — TAM/SAM/SOM built top-down and bottom-up then reconciled, segmentation, demand triangulation, and survey design. Use when sizing a market, writing a sizing memo, or fielding a survey.
license
MIT + Commons Clause
metadata.version
1.0.0
metadata.author
borghei
metadata.category
research-ops
metadata.domain
market-sizing
metadata.updated
2026-07-21
metadata.tags
tam, sam, som, market-sizing, segmentation, survey-design, demand

Market Research

Applied market research for people who have to defend a number in a room. This skill is about the operational craft: constructing a market size two independent ways, reconciling the gap, cutting the market into segments that behave differently, and fielding survey instruments that do not manufacture the answer you hoped for.

When to use this skill

  • Sizing a market for a board deck, investor memo, or funding request where the number will be challenged line by line
  • Reconciling a TAM you inherited — an analyst report says $12B, your bottom-up build says $700M, and you need to explain the gap
  • Segmenting a market before a pricing, packaging, or GTM decision
  • Triangulating demand signals (search volume, inbound, win rates, analyst data, competitor headcount) into one directional read
  • Designing a survey to answer a market question — willingness to pay, category awareness, switching intent — without leading the respondent
  • Auditing someone else's sizing before you sign off on it

Inputs the skill expects

  • The market definition in one sentence — including geography and buyer
  • A top-down anchor (published market value) with its source and vintage
  • Bottom-up unit economics — unit count, qualified share, annual value per unit
  • The decision the number is feeding (investment size, hiring plan, pricing)
  • Time horizon for SOM (1 year vs 3 years changes it by an order of magnitude)
  • For surveys: population size, target margin of error, mode (panel, list, intercept)

Clarify First

Before generating, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Market definition — what is in and what is out — the single biggest driver of the number; "dental software" and "dental practice management software for multi-chair EU practices" differ by 20x
  • The decision this sizing supports — a fundraise tolerates a wide TAM; a hiring plan needs a defensible SOM
  • Time horizon for SOM — 12-month obtainable share and 3-year obtainable share are different artifacts
  • Whether a published anchor exists and its vintage — a 2022 report in a 2026 memo needs an explicit growth bridge

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Workflows

Workflow 1 — Build and reconcile TAM/SAM/SOM
  1. Write the market definition sentence first. Everything downstream inherits it.
  2. Build the top-down chain: published market value, then named filters that each cut it (geography, segment, buyer qualification), each with a retention fraction and a stated justification.
  3. Build the bottom-up chain independently: unit count from a countable source, qualified share, annual value per unit, reachable share, expected win rate.
  4. Run the builder. It computes both chains, reconciles them layer by layer, and flags implausible ratios and divergence.
  5. Resolve every fail before the number leaves your machine. A warn needs a sentence in the memo, not a fix.
bash
python3 research-ops/market-research/scripts/tam_sam_som_builder.py \
  --input research-ops/market-research/assets/sample_market_model.json \
  --format text
Workflow 2 — Triangulate demand signals
  1. Collect every observable demand signal you have — search volume, inbound lead velocity, win rate by segment, analyst growth rates, competitor hiring, category conference attendance.
  2. Score each for source independence and directional strength.
  3. Run the triangulator to get a weighted demand index and, more importantly, the list of signals that contradict each other.
  4. Investigate contradictions before averaging them away. A conflicting signal is usually a segmentation boundary you have not drawn yet.
bash
python3 research-ops/market-research/scripts/demand_signal_triangulator.py \
  --input research-ops/market-research/assets/sample_demand_signals.json \
  --format text
Workflow 3 — Audit a survey instrument before fielding
  1. Draft the instrument with the market question stated at the top.
  2. Run the auditor. It checks each item for leading language, double-barrelled phrasing, absolutes, unbalanced or over-long scales, and missing escape options.
  3. Check the sample-size verdict — it computes required n from population, target margin of error, and confidence level.
  4. Fix every fail, then re-run. Field only on a clean run.
bash
python3 research-ops/market-research/scripts/survey_instrument_auditor.py \
  --input research-ops/market-research/assets/sample_survey.json \
  --format text

Decision frameworks

Which sizing method for which situation
SituationMethodWhy
Established category, published reports exist[PROVEN] Top-down anchored, bottom-up as a checkThe anchor is defensible; bottom-up catches definition drift
New category, no analyst coverage[PROVEN] Bottom-up only, stated as suchA top-down number for a category that does not exist yet is fiction
Adjacent expansion from an existing product[RECOMMENDED] Bottom-up from your own funnel conversionYour observed win rates beat any external estimate
Regulated market with registries[PROVEN] Bottom-up from the registry countCounting licensed entities is the strongest unit base available
Consumer market, behaviour-driven[RECOMMENDED] Top-down plus survey-derived incidenceUnit counts exist but qualification requires stated behaviour
Plausibility thresholds

These are the ratios the builder enforces. They are heuristics, not laws — but crossing one without an explanation in the memo is how sizing loses credibility.

RatioHealthy rangeFlag when
SAM / TAM5% – 40%Above 60% — you are claiming almost the whole market is addressable
SOM / SAM (3-year)1% – 10%Above 20% — implies category leadership inside the horizon
SOM / TAM0.1% – 5%Above 5% for a pre-scale company
Bottom-up vs top-down TAMWithin 3xAbove 3x warn, above 10x fail — the two builds are answering different questions
Show full SKILL.md (617 more words)Show less
Survey sample size at 95% confidence

Required n for a proportion estimate, finite population corrected. Use these as a sanity check on the auditor's output.

Population±10% MoE±5% MoE±3% MoE
50081218341
5,00095357880
100,000963831,056
1,000,000+973851,066

The jump from ±10% to ±5% quadruples cost for a band most market decisions do not need. [RECOMMENDED] Field at ±10% for directional category questions and reserve ±5% for pricing and packaging decisions where the band drives the choice.

Anti-Patterns

The Inherited TAM

Mistake: Copying a market size from an analyst report or a competitor's deck into your own memo, adjusting the geography, and presenting it as your build. Why it happens: The number is already large and already sourced, and building bottom-up takes two days you do not think you have. Instead: Use the published figure as the top-down anchor only, and always build the bottom-up chain alongside it. The reconciliation gap is the most informative artifact of the whole exercise — it tells you exactly which definition the report used and yours does not.

The Multiplication Fantasy

Mistake: SOM computed as "if we capture 1% of the TAM" with no mechanism behind the 1%. Why it happens: It sounds modest, so nobody challenges it, and it produces a convenient number without requiring a channel model. Instead: Build SOM from reachable units times expected win rate, where both come from something observed — your funnel, a pilot, or a comparable. If you cannot name the channel that reaches those units, you do not have a SOM.

The Stale Anchor

Mistake: A four-year-old market report used at face value in a current memo. Why it happens: It was the best available source when someone first built the model, and nobody re-checks a number that has been in the deck for a year. Instead: Record the vintage of every anchor. If it is more than 18 months old, apply an explicit growth bridge with a stated CAGR and show both the raw and bridged figures. An unbridged stale anchor invites the reviewer to discount everything downstream of it.

The Leading Instrument

Mistake: Asking "How valuable would an automated reporting feature be to your team?" and reporting the enthusiasm as demand evidence. Why it happens: The team already believes in the feature, and the question is written by the person who wants it built. Instead: Ask about the current behaviour and its cost — "How many hours last month did your team spend building reports manually?" — and let the demand fall out of the numbers. Run every instrument through the auditor before fielding; leading items are cheap to fix pre-field and impossible to fix post-field.

Segments That Do Not Behave Differently

Mistake: Cutting the market by company size or geography because that data is available, then finding every segment has the same conversion and the same ACV. Why it happens: Firmographic fields are in the CRM; behavioural ones are not. Instead: Segment on the variable that changes the buying decision — trigger event, existing tooling, regulatory obligation, or team structure. A segmentation is only useful if the segments have measurably different win rates or values.

Files

FilePurpose
scripts/tam_sam_som_builder.pyBuilds top-down and bottom-up TAM/SAM/SOM, reconciles them, flags implausible ratios
scripts/survey_instrument_auditor.pyChecks survey items for leading language, scale problems, and computes required sample size
scripts/demand_signal_triangulator.pyWeights and triangulates demand signals; surfaces contradictions and source concentration
references/market-sizing-methods.mdMethod selection, filter design, growth bridges, worked reconciliation examples
references/survey-design-methodology.mdQuestion construction, scale design, sampling frames, mode effects, field QA
assets/market-sizing-memo-template.mdThe memo structure a sizing number ships in
assets/sample_market_model.jsonRunnable input for the TAM/SAM/SOM builder
assets/sample_survey.jsonRunnable input for the survey auditor
assets/sample_demand_signals.jsonRunnable input for the demand triangulator

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

Files

SKILL.md and 9 other files (scripts, references, assets) in research-ops/market-research of borghei/Claude-Skills.

  • SKILL.md
  • assets/market-sizing-memo-template.md
  • assets/sample_demand_signals.json
  • assets/sample_market_model.json
  • assets/sample_survey.json
  • references/market-sizing-methods.md
  • references/survey-design-methodology.md
  • scripts/demand_signal_triangulator.py
  • scripts/survey_instrument_auditor.py
  • scripts/tam_sam_som_builder.py

Open the folder on GitHubat commit 4a698e8

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 skillborghei/Claude-Skills891—~2.8kAutomated safety check: PassMIT
Management ConsultantDogInfantry/claude-skill-management-consultant-B1136—~14kAutomated safety check: PassCustom licence
Market AnalyzerMathews-Tom/armory329—~2.4kAutomated safety check: PassMIT
Market Analysis Guidewentorai/research-plugins2981 repos~1.1kAutomated safety check: PassMIT
Market Research ReportsK-Dense-AI/claude-scientific-writer2.4k1 repos~3.5kAutomated safety check: PassMIT
Market Sizing Analysiswshobson/agents40k1 repos~620Automated safety check: PassMIT

Similar skills

  • Management Consultant

    DogInfantry/claude-skill-management-consultant-B1

    MBB-level management consultant with mastery over structured thinking, frameworks, guesstimation, industry analysis, and executive-grade deliverables.

    136 GitHub stars~14k tokensUpdated 19 days ago
    Product & Project ManagementAuto-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 4 days ago
    Product & Project ManagementAuto-check passed
  • Market Analysis Guide

    wentorai/research-plugins

    Structured frameworks for market sizing, competitive analysis, and strategic ...

    298 GitHub starsUsed in 1 repo~1.1k tokens
    Product & Project ManagementAuto-check passed
  • Market Research Reports

    K-Dense-AI/claude-scientific-writer

    Builds market research reports and market sizing or forecast scenarios in which every claim, source, assumption and uncertainty can be traced and audited.

    2.4k GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • Market Sizing Analysis

    wshobson/agents

    Calculate TAM/SAM/SOM for market opportunities using top-down, bottom-up, and value theory methodologies.

    40k GitHub starsUsed in 1 repo~620 tokens
    Product & Project ManagementAuto-check passed
  • Research Ops Skills

    alirezarezvani/claude-skills

    A skill your agent uses when planning, funding, scoping, or synthesizing enterprise research across workstreams — clinical study design, R&D program finance, market sizing/surveys, or product/user…

    28k GitHub stars~2.8k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    891 GitHub stars~3.1k tokensUpdated 3 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    891 GitHub stars~4.2k tokensUpdated 3 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    891 GitHub stars~3.4k tokensUpdated 3 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    891 GitHub stars~3.6k tokensUpdated 3 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    891 GitHub stars~3.4k tokensUpdated 3 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    891 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

Questions about Market Research

What does Market Research do?

Market sizing and market structure work — TAM/SAM/SOM built top-down and bottom-up then reconciled, segmentation, demand triangulation, and survey design. Market Research is an agent skill from borghei/Claude-Skills. Market sizing and market structure work — TAM/SAM/SOM built top-down and bottom-up then reconciled, segmentation, demand triangulation, and survey design.

When should I use Market Research?

Market Research fits situations like: sizing a market; writing a sizing memo; fielding a survey.

How do I install Market Research in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill market-research -a claude-code`. Or copy the skill folder (research-ops/market-research in borghei/Claude-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 borghei/Claude-Skills --skill market-research -a codex`. Or copy the skill folder (research-ops/market-research in borghei/Claude-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 borghei/Claude-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?

Going by SKILL.md and its folder, Market Research needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Market Research use?

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

How many tokens does Market Research use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.4k tokens, read only when the agent opens those files.

What are the alternatives to Market Research?

Skills that share tags, products or a category with Market Research: Management Consultant (DogInfantry/claude-skill-management-consultant-B1, 136 stars), Market Analyzer (Mathews-Tom/armory, 329 stars), Market Analysis Guide (wentorai/research-plugins, 298 stars) and Market Research Reports (K-Dense-AI/claude-scientific-writer, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Market Research?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 891 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.