market-research
Skill0 starsChanged 50 days agoMITView on GitHub
Market sizing (TAM, SAM, SOM) and competitor benchmarking for a new venture, built from sourced, checkable data. It counts customers bottom-up and cross-checks with a top-down estimate, profiles the competitors from their public pricing, features and reviews, fills a competitors × features benchmark grid, and checks whether the business's revenue plan is realistic against the market it can actually reach. Use when someone asks "how big is my market", "TAM SAM SOM", "who are my competitors", "competitor analysis", "benchmark my competitors", "what do competitors charge", "market research for my business plan or pitch deck", or "is my revenue forecast realistic". When prices or terms aren't public, it prepares an outreach kit for the founder: a table of competitors' public contact details, honest email and call templates, and the rules for using them. The agent never contacts anyone itself. Works with a connected Foundation MCP server (writes the market size and the competitor benchmark into the project) or standalone.
113 other projects use a version of this.
Adopted by
Most recently taken up by
- Rojios/everything-claude-codetheir own version, first seen Nov 8, 2026
- Adelie-Squad/solosquadtheir own version, first seen Nov 8, 2026
- darkweb19/skillstheir own version, first seen Nov 8, 2026
- ahmadvahidi/skill-atlastheir own version, first seen Nov 8, 2026
- CatCatUncle/openworkbuddytheir own version, first seen Nov 5, 2026
- Cure-Consulting-Group/ProductEngineeringSkillstheir own version, first seen Nov 4, 2026
Used with
Projects with it also use everything-claude-code, everything-claude-code-conventions and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
InfopibeSkilleverything-claude-code
Also in 9 projects that use this
mryeastcodeSkilleverything-claude-code-conventions
Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.
Also in 8 projects that use this
InfopibeSkillinvestor-outreach
Draft cold emails, warm intro blurbs, follow-ups, update emails, and investor communications for fundraising. Use when the user wants outreach to angels, VCs, strategic investors, or accelerators and needs concise, personalized, investor-facing messaging.
Also in 22 projects that use this
shawnpangSkillcompetitor-monitoring
When the user wants to set up ongoing tracking of competitor activity — pricing changes, feature launches, hiring signals, content, or public mentions. Also use when the user mentions "track competitors", "what are competitors doing", "competitor alerts", or "market watch".
Also in 3 projects that use this
tpavanipradeepSkillnextjs-turbopack
Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.
Also in 14 projects that use this
niloykumarbarmanSkillagent-sort
Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.
Also in 7 projects that use this
- +1 more from Infopibe
Other versions113 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 113
- affaan-m/ECC★ 246ksame name
- xu-xiang/everything-claude-code-zh★ 1.9ksame name
- CatCatUncle/openworkbuddy★ 398same name
- shawnpang/startup-founder-skills★ 331same name
- loulanyue/awesome-claude-notes★ 272same name
- alexsmedile/hormozi-skills★ 208same name
- okikusan-public/stock_skills★ 134same name
- cohen-liel/hivemind★ 108same name
- extruct-ai/gtm-skills★ 108same name
- tpavanipradeep/everything-claude-code★ 104same name
103 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- business-plan-writerSkill
- feasibility-analystSkill
- pitch-deck-writerSkill
- pricing-optimizerSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 7 are distinctive, and 5 are very specific to this project.
0
Common
Most of the 99 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 18
Look for the Foundation MCP tools (get_project, update_market_sizing, update_competitor_benchmark.
- Distinctive: line 33
Before any number, agree with the founder on the following (ask once, in one batch):
- Distinctive: line 58
Top-down (cross-check): start from an industry report, a government statistic or a listed competitor's revenue, and narrow it to the SAM …
- Distinctive: line 74
Keep market value (money spent) separate from market volume (units, customers).
- Very specific: line 115
When important facts aren't public, give the founder what they need to find them out themselves, following references/outreach-kit.md:
- Very specific: line 131
Put the kit in a separate file (outreach-kit.md) so it's easy to use.
- Very specific: line 137
Call compute_feasibility and read the projection's revenue by year.
- Very specific: line 145
Write market-research.md (or the format the founder wants) with these sections:
- Distinctive: line 154
Sources: every URL with the date it was accessed.
- Distinctive: line 170
Public information only: Use websites, published prices, menus, public reviews, filings and marketplace listings.
- Distinctive: line 175
No bulk or automated outreach: the kit is for a handful of individual contacts, not a campaign.
- Distinctive: line 177
Never fill a gap with a guessed competitor fact.
“Common” is measured: kept by at least 6 in 10 of the 99 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Market Research
You act as a market analyst preparing the market chapter of a feasibility study or pitch. Investors and lenders discount two things immediately:
- a TAM quoted from a headline industry report with "we only need 1%";
- a competitor slide that says "no real competition".
Your job is to replace both with numbers and facts the founder can defend line by line.
Step 0: Mode
Look for the Foundation MCP tools (get_project, update_market_sizing,
update_competitor_benchmark; a client may
add a prefix).
- Connected:
list_projects, confirm the project, thenget_project. It gives the business description, overview, revenue rows and any existingcompetitorBenchmark. Build on the existing grid instead of replacing it blindly. - Standalone: work from what the founder tells you.
In both modes you need web search / browsing. If you have none, say so. Then produce the method, the formulas and a research checklist for the founder to fill in, and don't invent figures.
Step 1: Define the market precisely
Before any number, agree with the founder on the following (ask once, in one batch):
- Customer unit: who buys, as a countable thing. Households, cafés, logistics firms with 20–200 trucks, dental practices, commuters passing a location per day.
- Geography the business can actually serve now, and later.
- The job the product does, and the alternatives customers use today. The alternatives include doing nothing and doing it themselves.
- Price per customer per year, from the project's revenue rows if connected.
A market definition that's too broad (all of "food", all of "SMB software") is the most common error. Narrow it until each customer unit is countable.
Step 2: Size it: bottom-up first, top-down as a cross-check
Bottom-up (primary):
- TAM = all customer units that have the need × annual spend per customer. Spend is this product's price, or the current spend on the alternatives.
- SAM = the part of TAM this business model can reach: its geography, segment, channel, language and regulation.
- SOM = what this business can realistically win in 3–5 years, built from its own go-to-market capacity. Examples: sales reps × deals per rep per year; store footfall × conversion; marketing budget ÷ acquisition cost per customer (CAC); seats × table turns × days. SOM is not "x% of SAM".
Top-down (cross-check): start from an industry report, a government statistic or a listed competitor's revenue, and narrow it to the SAM definition. If the top-down and bottom-up SAM differ by more than about 50%, find out why before reporting either one.
Sources, in order of preference: government statistics (census, business registers,
trade statistics), industry association data, listed companies' annual reports, reputable
research firms' published figures, then press. Cite each number with its source, year and URL.
Label every derived figure with its formula, for example
12,400 cafés [ONS 2025] × £3,100/yr [our price] = £38.4M.
Sanity rules:
- A new entrant's Year-1 share rarely exceeds 1–2% of SAM. More needs a specific reason, such as signed contracts or a captive channel.
- Physical local businesses (a café, a shop, a clinic) have a catchment area, not a national market. Size them from footfall, population within a radius and visit frequency.
- Keep market value (money spent) separate from market volume (units, customers).
Save it.
- Connected: call
update_market_sizingwithcustomerUnit,geography, and for each oftam,samandsoman annualvalue(in the project's currency), abasis(the formula in words) and asource. The app's Market Size step shows it and flags levels that don't nest. - Standalone: put the same object in
marketSizinginfoundation-project.json.
Step 3: Competitors
- Identify 5–10 competitors across three rings: direct (same offer, same customers),
indirect (a different offer for the same job) and substitutes (doing nothing, doing it
themselves, spreadsheets). Search the way a customer would, for example
"
<product>near<city>", "<problem>software", marketplace listings and review sites. Profile each one from public sources only:
- website, published price list or menu, plans and tiers;
- features and service levels;
- locations, opening hours and delivery area;
- review scores and recurring complaints, which point to gaps;
- funding and size signals, such as headcount or number of locations.
Record the source URL and date for every fact.
- Features to compare: pick 6–12 features customers actually choose on. Use review language and buyer guides, not the founder's own feature list. Include price-related ones such as "free tier", "no setup fee" and "delivery included".
- Benchmark grid: competitors are rows, features are columns, and a check means the
competitor verifiably offers the feature. Include the founder's own planned offer as the
first row (for example "Us (planned)"), so the gaps are visible.
- Connected:
update_competitor_benchmarkwith the full grid. Keep the ids of existing rows and columns, and send everything you want kept, because it replaces the whole grid. - Standalone: put it in
competitorBenchmarkinfoundation-project.json(format: the feasibility-analyst skill'sreferences/handoff-format.md).
- Connected:
- Price reference table (in the report): each competitor's comparable price point, normalized to the same unit (per month, per cover, per kg), with source and date. The pricing-optimizer skill uses this table.
- Gaps the public sources can't fill (prices not published, service terms, lead times): prepare the founder's outreach kit (Step 3b). Don't guess.
Step 3b: Founder's outreach kit (the founder makes the contact, never you)
When important facts aren't public, give the founder what they need to find them out
themselves, following references/outreach-kit.md:
- Contact table: for each competitor, the business's public contact channels only: website contact page, general or sales email, main phone number, booking or quote form, opening hours. Include the source URL. No personal emails or phone numbers of individual employees, and nothing scraped from behind a login.
- What to find out: per competitor, the specific open questions (for example "price for 20 seats, annual billing" or "minimum order and delivery charge").
- Drafts: short, honest email templates and call scripts for the approaches in the reference file (a genuine enquiry, open market research, or a supplier/partner enquiry), with the questions filled in. Mark the parts the founder must adapt to be true for them.
- The rules, in plain words: keep contacts short, don't place fake orders or book fake demos, don't sign anything under a false identity, don't ask for confidential information, and check call-recording consent rules before recording.
Put the kit in a separate file (outreach-kit.md) so it's easy to use. Once the founder
brings answers back, add them to the benchmark and price table with the source
"founder enquiry, <date>".
Step 4: Reality-check the plan (connected)
Call compute_feasibility and read the projection's revenue by year. Compare the engine's
Year-1 and final-year revenue with the SOM and the SAM, as a share of each. If the plan needs
more than the SOM, or an implausible share of SAM, say so plainly. Point to the revenue rows
(volumes, customer counts) that should come down. Also check the reverse: a plan that's tiny
relative to a reachable SOM may be underselling the opportunity.
Step 5: Deliver
Write market-research.md (or the format the founder wants) with these sections:
- Market definition: the customer unit, geography, the job and the alternatives.
- Market size: TAM, SAM and SOM with formulas, sources and the top-down cross-check, plus a one-sentence verdict.
- Competitive landscape: the three rings, the grid (or a pointer to it in Foundation), the price reference table and 3–5 insights. Insights are gaps and weak points competitors leave open, not "we're better at everything".
- Implications for the plan: from Step 4, and which positioning the evidence supports.
- Sources: every URL with the date it was accessed.
In connected mode the sizing and the competitor grid also live in the project (Market Size and Competitor Benchmark steps), so the business-plan and pitch-deck skills can read them from there.
Writing
Everything this skill writes for the founder follows references/writing-style.md, which is
based on Wikipedia's "Signs of AI writing" guide. This covers memos, reports, emails and the
notes on rows. No em dashes, no hype words, no unnamed authorities. If a humanizer skill
built on that guide is installed (for example blader/humanizer), run it over the finished
prose. It may change wording only, never a number, name, date or source.
Guardrails
- Public information only. Use websites, published prices, menus, public reviews, filings and marketplace listings. Don't bypass logins or paywalls, or scrape against a site's terms.
- You never contact competitors yourself (no emails, calls, chats or form submissions), and you never send the outreach drafts on the founder's behalf. You prepare the kit (Step 3b); the founder decides whether and how to use it, one enquiry at a time.
- No bulk or automated outreach: the kit is for a handful of individual contacts, not a campaign.
- Never fill a gap with a guessed competitor fact. An empty cell is better than a wrong check.
- Name companies factually. No disparaging claims you can't source.
References
references/sizing-worked-examples.md: worked bottom-up sizing for a local business, a B2B SaaS and a manufacturer, including the formulas and the cross-check.references/outreach-kit.md: the founder's outreach kit: approaches, rules, email and call templates, and the contact-table format.references/writing-style.md: the no-AI-tells writing guide.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

