SkillAgentSearch skills...

market-research

Industry and market research. Market sizing, structure, competition, regulation, supply chains, pricing, M&A. Produces a single compact, source-cited research report with Porter's Five Forces, HHI / CR4, PESTLE, and trade flows.

Install / Use

npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill market-research

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

95/100

Supported Platforms

Universal

Tags

Our assessment of market-research

market-research scores 95/100 on our quality scale, 50th of 319 Customer Support skills we index (top 16%).

Its SKILL.md is 18 KB long, well organised into 28 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.

With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so market-research is actively maintained.
  • Our last check on 2026-11-15 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

market-research compared with similar skills

All 4 of these similar skills score higher than market-research; compare them before choosing.

SkillScoreStarsUpdatedFormat
market-research (this skill)by brycewang-stanford954.4k54d agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install market-research?
Run npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill market-research. The install tabs above show the steps for each supported agent.
Which AI agents does market-research work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is market-research safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is market-research still maintained?
The repository was last updated about 2 months ago, so market-research is actively maintained.

name: market-research description: Industry and market research. Market sizing, structure, competition, regulation, supply chains, pricing, M&A. Produces a single compact, source-cited research report with Porter's Five Forces, HHI / CR4, PESTLE, and trade flows. Supports UK, US, EU, Australia, and global scope, with multi-geography comparison. allowed-tools:

  • Bash
  • Read
  • Write
  • Glob
  • AskUserQuestion
  • Skill
  • WebSearch
  • WebFetch

Only stop to ask the user when: the sector or geography is undefined, or a non-standard analysis focus is requested. Never stop to ask about: data source selection (use the source hierarchy), section ordering, Porter / PESTLE structure, or output filename.

<!-- preamble: update check -->

Before starting, run this silently. If it outputs UPDATE_AVAILABLE, tell the user: "A new version of econstack is available. Run cd ~/.claude/skills/econstack && git pull to update." Then continue with the skill normally.

~/.claude/skills/econstack/bin/econstack-update-check 2>/dev/null || true
<!-- preamble: project learnings -->

After the update check, run this silently to load prior learnings for this project:

eval "$(~/.claude/skills/econstack/bin/econstack-slug)"
~/.claude/skills/econstack/bin/econstack-learnings-read --limit 3 2>/dev/null || true

If learnings are found, apply them. When a prior learning influences a decision, note: "Prior learning applied: [key]".

Capturing new learnings: After completing this skill, log new insights via:

~/.claude/skills/econstack/bin/econstack-learnings-log '{"skill":"...","type":"...","key":"...","insight":"...","confidence":N,"source":"observed|user-stated|inferred"}'

Types: framework (preferred appraisal framework), parameter (custom overrides), data-source (preferred data), output (past report references), operational (tool/env quirks), preference (formatting/style). Confidence: 9-10 observed/stated, 6-8 strong inference, 4-5 weak. User-stated never decays; observed/inferred lose 1 point per 30 days. All data stored locally. Nothing transmitted.

<!-- preamble: parameter database check -->

After the update check, verify the parameter database is available and check staleness:

PARAMS_DIR="$HOME/econstack-data/parameters"
if [ -d "$PARAMS_DIR" ]; then
  PARAM_COUNT=$(find "$PARAMS_DIR" -name "*.json" 2>/dev/null | wc -l | tr -d ' ')
  echo "PARAMS: $PARAM_COUNT files loaded from $PARAMS_DIR"

  # Check for stale files (last_verified > 2 years ago)
  STALE=$(find "$PARAMS_DIR" -name "*.json" -mtime +730 2>/dev/null | wc -l | tr -d ' ')
  if [ "$STALE" -gt 0 ]; then
    echo "PARAMS_WARNING: $STALE file(s) not updated in 2+ years. Run: cd ~/econstack-data && git pull"
  fi
else
  echo "PARAMS: not found. Using built-in defaults. For full parameter support: git clone https://github.com/charlescoverdale/econstack-data.git ~/econstack-data"
fi

If PARAMS_WARNING appears, tell the user which parameter files may be stale and recommend updating. Continue with the skill normally using whatever parameters are available.

<!-- preamble: safety hooks -->

Safety rules for this skill:

  1. Parameter database is read-only. Never write to, modify, or delete files in ~/econstack-data/parameters/. These are shared, versioned parameters maintained separately. If a parameter needs updating, tell the user to update the econstack-data repo.

  2. Confirm before overwriting. Before writing an output file, check if a file with the same name already exists. If it does, ask the user: "A file named [filename] already exists. Overwrite it, or save with a new name?" Do not silently overwrite.

<!-- preamble: completion status -->

At the end of every skill run, report one of these statuses:

  • DONE: Analysis complete, output generated, all sections finished.
  • DONE_WITH_CONCERNS: Output generated but with caveats (e.g., data gaps, assumptions that need review, sections below expected depth).
  • BLOCKED: Cannot proceed (e.g., missing critical input, parameter database unavailable, framework not supported).
  • NEEDS_CONTEXT: Need more information from the user before continuing.

Format: STATUS: [status] | [one-line reason]

/market-research: Industry and Market Analysis

Produces a structured, source-cited market research report for any industry or product. First-time users get a complete analysis from one invocation covering market sizing, key players, concentration, Porter's Five Forces, PESTLE macro-environment, regulatory environment, supply chains, and outlook. Every data point is cited.

Arguments

/market-research [sector or product] [options]

Examples:

/market-research "UK grocery retail"
/market-research "semiconductors" --geo global
/market-research "residential mortgages" --geo uk,us
/market-research "UK childcare" --focus regulation
/market-research "EV batteries" --depth quick --format pptx

Options:

  • --geo <code(s)> : uk (default), us, eu, au, or global. Multi-geography via commas: --geo uk,us.
  • --depth <level> : quick (one-page briefing), standard (default, full report), deep (extended with primary research pointers).
  • --focus <topic> : Narrow to a theme. Options: sizing, competition, regulation, supply-chain, pricing, outlook. Reduces the report to the relevant sections.
  • --section <name> : Emit only one sub-component. Options: full (default), summary, sizing, players, concentration, porter, pestle, regulation, supply, trade, pricing, outlook. Combinable with commas.
  • --format <type> : Output format(s). markdown (default, always generated), xlsx, word, pptx, pdf, or all.
  • --client "Name" : Add "Prepared for" metadata. Also shapes writing register.

Supported geographies

| Code | Scope | Primary sources | |------|-------|----------------| | uk | United Kingdom (default) | ONS, CMA, ORR, Ofgem, Ofcom, FCA, HMRC trade data | | us | United States | BLS, Census, FTC, FCC, NAICS data, BEA | | eu | European Union | Eurostat, European Commission DG COMP, Comext trade | | au | Australia | ABS, ACCC, APRA, industry code ANZSIC, DFAT trade | | global | Global / multi-region | UN Comtrade, IMF, OECD, World Bank, UNCTAD |

Multi-geography via commas: --geo uk,us,eu. Each geography is reported side by side in the main tables.

Instructions

Step 1: Detect sector, geography, and focus

If the user argument does not specify a sector, ask once. Detect geography from context ("UK grocery" → uk). Default to uk and standard depth if unclear.

Parse --focus if set to narrow the scope.

Step 2: Source hierarchy

When gathering data, prefer sources in this order:

  1. Official statistics: ONS, BLS, Eurostat, ABS (for sizing, employment, GVA)
  2. Regulatory filings: CMA, FTC, EC DG COMP, ACCC (for competition structure, M&A history)
  3. Trade data: HMRC, UN Comtrade, Comext, DFAT (for imports and exports)
  4. Industry codes: SIC (UK), NAICS (US), NACE (EU), ANZSIC (AU) for precise scoping
  5. Company filings: Annual reports, 10-Ks, competition merger notifications (for player-level data)
  6. Trade associations: sector-specific reports (with caveats on methodology)
  7. News and trade press: recent M&A, pricing moves, regulatory announcements

Do NOT use unverifiable blog posts, low-credibility aggregators, or AI-generated summaries.

Step 3: Build the report (silent)

Walk through the standard sections internally. Do not narrate.

  1. Executive summary: one paragraph, the three things the decision-maker needs.
  2. Market sizing: total addressable market, served market, growth rate, historical 5-year context.
  3. Segmentation: 3-5 key segments with size shares.
  4. Key players: top 5-10 with market share, recent strategic moves.
  5. Concentration: HHI and CR4 from public data. Note if data is incomplete.
  6. Porter's Five Forces: one paragraph per force with a qualitative rating (Low / Moderate / High threat or rivalry).
  7. PESTLE: one line per factor covering Political, Economic, Social, Technological, Legal, Environmental.
  8. Regulatory environment: main regulators, recent or upcoming regulatory changes.
  9. Supply chain: upstream inputs, midstream transformation, downstream distribution, vulnerability points.
  10. Trade flows: imports and exports, tariff position, trade balance in the sector.
  11. Pricing and margins: price trends, margin profile, elasticity if known.
  12. Outlook and scenarios: 3-year outlook, upside and downside scenarios.

Step 4: Write the output

Save market-[slug]-[YYYY-MM-DD].md with this structure.

<!-- KEY NUMBERS
type: market-research
sector: [sector]
geography: [geo]
depth: [depth]
market_size_m: [value]
growth_rate_pct: [value]
hhi: [value]
cr4: [value]
date: [YYYY-MM-DD]
-->

# Market Research: [Sector] ([Geography])

**Date**: [YYYY-MM-DD] · **Geography**: [geography] · **Depth**: [depth]

## Executive summary

[One paragraph, three takeaways. Written for the decision-maker the report is for. No filler.]

## Market sizing

[Two paragraphs: total addressable market, served market, growth rate, historical 5-year context. One small table.]

| Metric | Value | Source |
|--------|------:|--------|
| Total market size (latest year) | [currency][val] | [Source] |
| 5-year CAGR | [val]% | [Calculated from Source] |
| Forecast growth (3-year) | [val]% | [Forecast source] |

## Segmentation

Table: Market segments.

| Segment | Size ([currency]) | Share | Growth |
|---------|------------------:|------:|-------:|
| [Segment 1] | [val] | [val]% | [val]% |
| [Segment 2] | [val] | [val]% | [val]% |
| [Segment 3] | [val] | [val]% | [val]% |

## Key players

Table: Top players.

| Player | Market share | Strategic move |
|--------|-------------:|----------------|
| [Player 1] | [val]% | [Recent move, one line] |
| [Player 2] | [val]% | [Recent move, one line] |
| [Player 3] | [val]% | [Recent move, one line] |

## Market structure

| Metric | Value | Interpretation |
|--------|------:|----------------|
| HHI | [val] | [Unconcentrated / Moderately concentrated / Highly concentrated] |
| CR4 | [val]% | [Competitive / Moderate / Concentrated] |
| Barriers to entry | [Low / Moderate / High] | [One line] |

## Porter's Five Forces

| Force | Rating | Key drivers |
|-------|:------:|-------------|
| Competitive rivalry | [L/M/H] | [one line] |
| Threat of new entrants | [L/M/H] | [one line] |
| Bargaining power of suppliers | [L/M/H] | [one line] |
| Bargaining power of buyers | [L/M/H] | [one line] |
| Threat of substitutes | [L/M/H] | [one line] |

**Overall attractiveness**: [Unattractive / Moderate / Attractive]. [One-line reason.]

## PESTLE

| Factor | Key point |
|--------|-----------|
| Political | [One line] |
| Economic | [One line] |
| Social | [One line] |
| Technological | [One line] |
| Legal | [One line] |
| Environmental | [One line] |

## Regulatory environment

[Two paragraphs: main regulators, upcoming changes, compliance burden.]

## Supply chain

[Two paragraphs: upstream inputs and their sourcing, midstream transformation, downstream distribution, points of vulnerability.]

## Trade flows

Table: Trade position.

| Flow | Value ([currency]) | Top partner | Tariff regime |
|------|-------------------:|-------------|---------------|
| Imports | [val] | [country] | [regime] |
| Exports | [val] | [country] | [regime] |
| **Net trade** | **[val]** | | |

## Pricing and margins

[One paragraph: price trends, margin profile, elasticity if known.]

## Outlook and scenarios

**Central**: [One paragraph, 3-year outlook.]

**Upside scenario**: [One-liner on what would make it better.]

**Downside scenario**: [One-liner on what would make it worse.]

## References

[List of all cited sources with URLs. Every data point in the report must map to one of these sources.]

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars4.4k
CategoryCustomer
Updated1mo ago
Forks527

Languages

Stata

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium
market-research — Universal Skill: Install & Safety Check | SkillAgent