Skip to main content
skill CX Codex

market-researcher · jakeschincariol — Claude Code skill: market research

The market-researcher Claude Code skill finds business problems that already have a budget. It responds to requests for product ideas, market research, and idea validation.

MIT ★ 92 updated 2026-11-06

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Jakeschincariol/whale-skill
/plugin install whale-skill@whale-skill
Open on GitHub

What market-researcher does

The skill finds business problems that companies already spend money to solve, then builds a table with the problem, payer, current spend, and source. When a figure is estimated, it labels the estimate and records the calculation. It ranks the options and helps select one.

Research draws on public vendor pricing, job ads, industry forums and reviews, filings, and trade press. The board.py and problems.py scripts set up a board, add problems, and rank them; the data file defaults to whale/whale.json. The first run asks for a name, business name, email, postal address, and target customers. Python 3 is required.

The skill only reads and writes notes. It does not send messages or book anything, and it avoids material behind logins or paywalls. It does not treat an idea as validated without actual payments.

What it helps with

  • find business problems with existing spending
  • match buyers and current costs to sources
  • label estimates and record how they were calculated
  • rank candidate problems and choose one

Example prompts for the agent

  • Find a business problem companies already pay to solve.
  • Research this idea: who would pay, and what do they spend now?
  • List and rank problems for a type of business I know.

How to install market-researcher

1Plugin marketplace

/plugin marketplace add Jakeschincariol/whale-skill
/plugin install whale-skill@whale-skill

This installs the whole whale-skill plugin with all its skills

2Skills CLI (Vercel)

npx skills add Jakeschincariol/whale-skill --skill market-researcher -a claude-code

3Manually: put the files in place

~/.claude/skills/market-researcher/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/market-researcher/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about market-researcher

How do I install market-researcher in Claude Code?

Add the marketplace with /plugin marketplace add Jakeschincariol/whale-skill, then install the skill with /plugin install whale-skill@whale-skill.

What does market-researcher do?

It finds business problems with existing spending, records buyers, amounts, and sources, then ranks the options and helps choose one.

What does market-researcher need to run?

It requires Python 3. The initial setup asks for a name, business name, email, postal address, and target customers.

Source text

SKILL.md · MIT
---
name: market-researcher
description: >-
  Market Researcher. Finds problems businesses already pay thousands to solve. Looks for money that
  is already leaving their accounts: vendors, agencies, outsourced services and salaried jobs that
  exist only because of one painful problem. Builds a table of the problem, who pays and what they
  pay today, with a source for every number or a clearly marked estimate with its working, then
  helps you pick the one to go after and sets up the board the other ten Whale skills share. Use
  when the user says "what should I build", "find me a problem", "market research", "validate this
  idea", "who would pay for this", "what do businesses pay for", or "set up the whale skill".
argument-hint: "[init | add <problem> | rank | pick <problem>]"
---

# market-researcher

Don't start with an idea. Start with a line on somebody's bill. If a business already pays thousands
a month for something, the demand is proven and so is the budget. This skill finds those lines.

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/board.py" init --name "You" --company "Your Company" \
    --email [email protected] --address "100 Main St, Austin, TX 78701" \
    --product "Your Product" --does "Chases your late invoices automatically" \
    --value_line "It costs about a third of what you pay a collections service today."
python3 "${CLAUDE_SKILL_DIR}/problems.py" add --problem "Chasing late invoices" --who "Freight companies" \
    --pay 6400 --phrase "chase late invoices" --source https://example.com/collections-pricing
python3 "${CLAUDE_SKILL_DIR}/problems.py" add --problem "Scheduling field crews" --who "Landscapers" \
    --pay 2900 --estimate --basis "one office admin, half time, at the local median wage"
python3 "${CLAUDE_SKILL_DIR}/problems.py" rank
python3 "${CLAUDE_SKILL_DIR}/problems.py" pick --id chasing-late-invoices
python3 "${CLAUDE_SKILL_DIR}/board.py" board
```

Every command takes `--file` (default `whale/whale.json`).

## First run

Ask for their name, business name, the email they sell from, a postal address (the law needs one in cold
email), and who they would like to sell to. Don't guess any of these. `board.py init` writes them down.
`--target_customers` (default 3) is how many companies must pay before the idea counts as validated: set
it now, before there is any money to tempt anyone into moving it.

## Steps

1. **Pick a kind of business.** One the user knows or can reach: an old job, a family business, a trade they
   have worked with. It is much easier to sell to people whose world you know.
2. **Look for money already moving.** Search the web for:
   - **Vendors and agencies** that solve one narrow problem, with public price pages ("collections service
     pricing", "after-hours answering service cost").
   - **Job ads** that exist only because of the problem. A posted salary is a number you can cite.
   - **Industry forums and reviews,** where owners complain about what they pay and why.
   - **Public filings and trade press,** for the bigger companies.
3. **Write it down with the number.** `problems.py add`. A number needs `--source` (a link, or what someone told
   you and when). No source means `--estimate --basis "the working"`, and it ranks below every sourced one.
   `--phrase` is how it reads in a pitch: "pay about $6,400 a month to ___".
4. **Rank and read it back.** `problems.py rank` prints the table. Under $1,000 a month is flagged: it is rarely
   worth a decision maker's time.
5. **Talk to someone.** Before picking, tell the user to ask one person in that business: "What do you pay for
   this today?" Research finds the problem. A person confirms it.
6. **Pick one.** `problems.py pick`. Then `/demo-builder` shows the answer and `/whale-hunter` finds who decides.

## What makes a good one

- Money is already being spent, and you can say how much.
- It repeats every month. A one-off fix is a project, not a product.
- One person's budget covers it, so one person can say yes.
- You could show it working in 2 minutes with sample data.

## Example from the reel

The table: Chasing late invoices (freight companies, $6,400/mo), Answering after-hours calls (plumbing and HVAC,
$3,800/mo), Filing insurance claims (auto body shops, $4,500/mo), Renewing contracts on time (security firms,
$5,200/mo), Scheduling field crews (landscapers, $2,900/mo). The pick is the first. At North Pier Logistics, "Invoice
collections service, $6,400.00" is a line on their monthly expenses. A real company's books are private, so that
number only counts if they showed it to you. The whole story is `whale.example.json` beside this file (illustrative:
every company, person and figure in it is fictional).

## What it never does

- Never states a number it can't source. An estimate is always labelled as one, with its working.
- Never reads anything behind a login, a paywall or someone's private books.
- Never tells the user the idea is validated. Only money does that: `/pre-sale validated`.

## Consent and truth

- Nothing is sent, booked or charged without the user's explicit yes. This skill only reads and writes notes.
- Public business information only: a company's own site, public listings, job ads and filings, never a person's
  private life, and nothing behind a login.
- Never invent a number, a result, a client or a source. Fill in only what is true and ask when something is missing.

© Jake Schincariol · MIT · Jakeschincariol/whale-skill

Similar skills

All skills for Finance and business →

market-researcher by other authors comes first.

market-researcher tronghieu The market-researcher skill researches market size, competitors, and demand signals using cited sources. Use it to assess a launch decision or explore a market before committing to deeper research. CX Codex +1 ★ 117repo stars market-research-reports K-Dense-AI market-research-reports builds evidence-traceable market reports and models assumption-driven TAM, SAM, and SOM forecast scenarios. CX Codex +1 2,200installs validate-idea emotixco The validate-idea Claude Code skill evaluates a startup idea before development begins. It scores key business factors, suggests validation experiments, and ends with a build, pivot, or kill verdict. CX Codex +1 ★ 900repo stars voltagent-research VoltAgent Community voltagent-research — a Claude Code plugin bundle of specialized subagents for market research, cohort retention analysis, A/B test evaluation, and scientific literature search. ★ 26,718repo stars market-research c0x12c market-research is a Claude Code skill for researching markets, competitors, investors, and technology before testing a business idea or contacting a fund. CX Codex +1 ★ 111repo stars asb-problem asmartbear The asb-problem skill breaks a business idea into seven multiplying factors and works out whether it holds up as a business. Useful before you commit to building. CX Codex +1 751installs market-research-analysis manojbajaj95 market-research-analysis is a Claude Code skill for sizing markets, comparing competitors, and studying customer behavior. It activates for industry research, market reports, and opportunity assessment. CX Codex +1 880installs

From the same set12

The whole set →
case-study A skill for Claude Code drafts a customer case study from real figures and the customer's own words. It runs when asked for a testimonial or customer story after delivery. CX Codex +1 ★ 92repo stars requirements The requirements Claude Code skill turns paying customers’ requests into a ranked feature list. It activates after a customer pays or when the conversation turns to scope, specs, or feature requests. CX Codex +1 ★ 92repo stars launch-planner The launch-planner Claude Code skill schedules a product launch after a customer pays. It works back from the promised delivery date and holds the public release until customer orders are fulfilled. CX Codex +1 ★ 92repo stars objection-handler The objection-handler Claude Code skill drafts replies to sales objections using the terms of your deal. It activates when someone pushes back, asks a question, or sends a message you’re unsure how to answer. CX Codex +1 ★ 92repo stars follow-up This Claude Code skill tracks follow-ups after a pitch or offer. It lists deals due for a message, drafts one, then waits for approval before sending. CX Codex +1 ★ 92repo stars whale-hunter The whale-hunter Claude Code skill finds company decision-makers and drafts a tailored pitch. It starts when asked to identify a buyer, locate a CFO, or write a cold email. CX Codex +1 ★ 92repo stars pre-sale This Claude Code skill manages presales before a product is built and captures buyer requirements. It tracks payments and promised delivery dates. CX Codex +1 ★ 92repo stars whale-skill The whale-skill Claude Code plugin helps test demand before a product launch, from market research through launch planning. Its skills prepare demos, offers, and pre-sales. ★ 92repo stars

Project sponsors

Companies that keep this analytics open