Agent skill

Market Research

by davepoon in davepoon/buildwithclaude

Manages the founder's market understanding — running initial market research, updating findings, and answering questions about market size, customer segments, buying behavior, pricing benchmarks…

MITAuto-check passedMarketing & SEO

Install Market Research

skills CLI
$ npx skills add davepoon/buildwithclaude --skill market-research -a claude-code

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

GitHub CLI
$ gh skill install davepoon/buildwithclaude 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/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/startup-superpowers/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
3.6k
Token cost
~928 tokens
SKILL.md length
416 words
Files
2 (incl. references)
Skills in repo
247
Repo updated
First seen
Licence
MIT

At a glance

Manages the founder's market understanding — running initial market research, updating findings, and answering questions about market size, customer segments, buying behavior, pricing benchmarks…

  • The conversation touches market size (TAM/SAM/SOM)
  • SKILL.md covers Before you start, When market research already…, When no market research exists and Ad-hoc web search vs.…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Who the buyers are and how they make decisions

What it does

Market Research is an agent skill from davepoon/buildwithclaude. Manages the founder's market understanding — running initial market research, updating findings, and answering questions about market size, customer segments, buying behavior, pricing benchmarks, and industry trends. Use when the conversation touches market size (TAM/SAM/SOM), who the buyers are and how they make decisions, what people typically pay, industry tailwinds or headwinds, or when the founder wants to understand the broader landscape their idea sits in.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/initial-market-research.md`).

It sits in Marketing & SEO, covering Market research. The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.

When your agent uses it

  • The conversation touches market size (TAM/SAM/SOM)
  • Who the buyers are and how they make decisions
  • What people typically pay
  • Industry tailwinds

Example prompts

  • “Use the market-research skill to manage the founder's market understanding — running initial market research, updating findings, and answering…”
  • “/market-research”

What it can do on your machine

Read from SKILL.md and the folder at commit 616deb5. 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 928 tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 121 tokens; SKILL.md has 416 words of instructions outside code blocks.

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

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 davepoon/buildwithclaude at commit 616deb5, republished under its MIT licence (© davepoon). 416 words, ~928 tokens.

Download SKILL.mdSave it as .claude/skills/market-research/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
market-research
description
Manages the founder's market understanding — running initial market research, updating findings, and answering questions about market size, customer segments, buying behavior, pricing benchmarks, and industry trends. Use when the conversation touches market size (TAM/SAM/SOM), who the buyers are and how they make decisions, what people typically pay, industry tailwinds or headwinds, or when the founder wants to understand the broader landscape their idea sits in.

Market Research

Help the founder understand the market they're entering — whether it's real, who's in it, how buyers behave, and what they expect to pay. This context strengthens interviews, sharpens hypotheses, and gives the founder a confident answer to "what's the market opportunity?"

Before you start

Read startup/core.md to load project context (name, seed description, type of business — B2B or B2C — and all fields under ## Core).

Check if startup/market-research.md exists.


When market research already exists

Load it for context. Infer intent from the conversation — don't ask "what do you want to do?" If the founder is:

  • Asking about a specific dimension (size, segments, pricing, trends) — answer from the existing file; if the file is thin on that dimension, offer to run targeted research to fill it in
  • Wanting to update a section — read the file, discuss the new information, propose the change, get confirmation, write it back. Update last_updated in frontmatter
  • Flagging the research as stale — set status: needs-refresh in frontmatter and offer to re-run the full research or a targeted pass on specific sections
  • Wanting web research on a specific topic — dispatch the web-researcher agent (fast model) with a focused prompt about that market dimension; incorporate findings into the relevant section; save the full output to startup/research/{YYYY-MM-DD}-{topic-slug}-research.md with frontmatter date, topic, and source_skill: market-research
  • Asking how market research connects to hypotheses — surface which findings in the file could confirm or challenge existing hypotheses, and suggest updating hypothesis status or Notes accordingly

When updating the file, follow the format conventions:

  • YAML frontmatter with version (number), last_updated (ISO date), type (b2b or b2c), and status (draft, complete, or needs-refresh)
  • H1 heading: Market Research — {Project Name}
  • Sections: Market Overview, Customer Segments, Buying Behavior, Pricing Landscape, Trends, Key Sources, Open Questions

Read before writing, propose before saving, get confirmation.


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

When no market research exists

Load the reference file for the guided first-time workflow:

.claude/skills/market-research/references/initial-market-research.md

The reference file's instructions take over from this point.


Ad-hoc web search vs. dispatching web-researcher

Not every web question needs a subagent:

  • Inline WebSearch / WebFetch (you, the main agent): single-fact lookups ("what does Pendo charge?", "is ACME still active?"), quick verification of a claim the founder made, one data point asked about in flow. Stays in conversation, no persistence needed.
  • Dispatch web-researcher: multi-source passes that benefit from an isolated context (scanning pricing across a whole category, surveying buyer-behavior signals across communities, structured landscape passes). Output is structured and gets saved to startup/research/{YYYY-MM-DD}-{topic-slug}-research.md for later reference.

Rough rule: one fact in flow → inline. Multi-source or results-should-persist → dispatch.

© davepoon, 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 1 other file (references) in plugins/startup-superpowers/skills/market-research of davepoon/buildwithclaude.

  • SKILL.md
  • references/initial-market-research.md

Open the folder on GitHubat commit 616deb5

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 skilldavepoon/buildwithclaude3.6k—~928Automated safety check: PassMIT
Competitor Comparison Matrixfirecrawl/web-agent1.2k—~1.1kAutomated safety check: PassMIT
Consulting Analysisbytedance/deer-flow84k4 repos~8.4kAutomated safety check: PassMIT
Startup Validatorailabs-393/ai-labs-claude-skills4551 repos~2.8kAutomated safety check: PassMIT
Competitive Analysis BriefNateBJones-Projects/OB14.7k—~1.1kAutomated safety check: PassCustom licence
Market AnalysisYicunAI/Pnlclaw-community197—~364Automated safety check: PassAGPL-3.0

Similar skills

  • Competitor Comparison Matrix

    firecrawl/web-agent

    Compares two or more products or companies on pricing, features and positioning by scraping their sites, and returns a normalized JSON matrix.

    1.2k GitHub stars~1.1k tokensUpdated 5 mo ago
    Marketing & SEOAuto-check passed
  • Consulting Analysis

    bytedance/deer-flow

    A skill your agent uses when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial…

    84k GitHub starsUsed in 4 repos~8.4k tokens
    Marketing & SEOAuto-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
  • Competitive Analysis Brief

    NateBJones-Projects/OB1

    Turns a competitor set into a decision-ready brief: profiles, pricing and packaging comparisons, a positioning map, a SWOT and recommended moves for operators and founders.

    4.7k GitHub stars~1.1k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Market Analysis

    YicunAI/Pnlclaw-community

    Analyzes current market state and short-term trends using ticker, candle, and narrative context

    197 GitHub stars~364 tokensUpdated 6 mo ago
    Marketing & SEOAuto-check passed
  • Reddit Insights

    lignertys/reddit-research-skills

    Searches Reddit posts by meaning through the reddapi.dev index, with topic momentum and subreddit lookup, to research how people describe problems and compare tools.

    14 GitHub stars~2.2k tokensUpdated 26 days ago
    Marketing & SEOAuto-check: warnings

More from davepoon/buildwithclaude

All 247 skills in this repo
  • iOS Hig Design Guide

    davepoon/buildwithclaude

    Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.

    3.6k GitHub stars~735 tokensUpdated today
    Auto-check passed
  • Video Downloader

    davepoon/buildwithclaude

    Download YouTube videos with customizable quality and format options.

    3.6k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Qwen Vision

    davepoon/buildwithclaude

    A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…

    3.6k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Atlas Cloud Media

    davepoon/buildwithclaude

    Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.

    3.6k GitHub stars~852 tokensUpdated today
    Auto-check passed
  • Browser Extension Launch

    davepoon/buildwithclaude

    面向没有编程经验的用户,把想法做成可试用的浏览器插件,并完成检查、商店材料、审核提交和上线验证;也用于继续已有插件、排错和发布新版。用户说“帮我做个插件”“把插件上架”“继续我的插件”时使用。普通网站开发、仅查询插件知识不触发。

    3.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Slack Gif Creator

    davepoon/buildwithclaude

    Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.

    3.6k GitHub starsUsed in 12 repos~4.3k tokens
    Auto-check passed

Categories

Questions about Market Research

What does Market Research do?

Manages the founder's market understanding — running initial market research, updating findings, and answering questions about market size, customer segments, buying behavior, pricing benchmarks…. Market Research is an agent skill from davepoon/buildwithclaude. Manages the founder's market understanding — running initial market research, updating findings, and answering questions about market size, customer segments, buying behavior, pricing benchmarks, and industry trends.

When should I use Market Research?

Market Research fits situations like: the conversation touches market size (TAM/SAM/SOM); who the buyers are and how they make decisions; what people typically pay; industry tailwinds.

How do I install Market Research in Claude Code?

Run `npx skills add davepoon/buildwithclaude --skill market-research -a claude-code`. Or copy the skill folder (plugins/startup-superpowers/skills/market-research in davepoon/buildwithclaude) 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 davepoon/buildwithclaude --skill market-research -a codex`. Or copy the skill folder (plugins/startup-superpowers/skills/market-research in davepoon/buildwithclaude) 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 davepoon/buildwithclaude --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 928 tokens (SKILL.md is roughly 3.7k 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 3.2k 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: Competitor Comparison Matrix (firecrawl/web-agent, 1.2k stars), Consulting Analysis (bytedance/deer-flow, 84k stars), Startup Validator (ailabs-393/ai-labs-claude-skills, 455 stars) and Competitive Analysis Brief (NateBJones-Projects/OB1, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Market Research?

davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,610 GitHub stars. The repository holds 247 skills in this directory. The repository was last updated on October 9, 2026.

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