Startup Design
ferdinandobons/startup-skill
Design, validate, and plan a startup from scratch. An agent skill from ferdinandobons/startup-skill.
A skill your agent uses when a MARKET as a whole needs a defensible picture — TAM/SAM/SOM sized top-down AND bottom-up until the two converge, cut into reachable segments with one named beachhead…
$ npx skills add ericrisco/rsc-harness --skill market-research -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ericrisco/rsc-harness market-research --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/market-research .claude/skills/market-research && rm -rf skills-srcUse ~/.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/
Install the "market-research" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/market-research into .claude/skills/market-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "market-research", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ericrisco/rsc-harness/tree/main/skills/market-researchType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ericrisco/rsc-harness --skill market-research -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ericrisco/rsc-harness market-research --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/market-research .agents/skills/market-research && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "market-research" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/market-research into .agents/skills/market-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "market-research", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ericrisco/rsc-harness --skill market-research -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ericrisco/rsc-harness market-research --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/market-research .cursor/skills/market-research && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "market-research" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/market-research into .cursor/skills/market-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "market-research", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ericrisco/rsc-harness.git --path skills/market-research--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ericrisco/rsc-harness --skill market-research -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ericrisco/rsc-harness market-research --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/market-research .gemini/skills/market-research && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "market-research" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/market-research into .gemini/skills/market-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "market-research", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ericrisco/rsc-harness market-researchInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ericrisco/rsc-harness --skill market-research -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/market-research .github/skills/market-research && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "market-research" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/market-research into .github/skills/market-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "market-research", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ericrisco/rsc-harness --skill market-research -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ericrisco/rsc-harness market-research --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/market-research .opencode/skills/market-research && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "market-research" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/market-research into .opencode/skills/market-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "market-research", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
market-researchA skill your agent uses when a MARKET as a whole needs a defensible picture — TAM/SAM/SOM sized top-down AND bottom-up until the two converge, cut into reachable segments with one named beachhead…
Market Research is an agent skill from ericrisco/rsc-harness. Use when a MARKET as a whole needs a defensible picture — TAM/SAM/SOM sized top-down AND bottom-up until the two converge, cut into reachable segments with one named beachhead, demand proven real, and a dated source behind every figure. NOT profiling named rivals and their moves (that is competitor-watch), NOT building a list of accounts to sell to (that is lead-gen).
Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `evals/README.md`, `evals/cases.yaml` and `references/demand-signals.md`).
It sits in Marketing & SEO, covering Market research, Market sizing and Lead generation. The repository describes itself as: Your agent invents things because it has no memory, and can't touch your database because it has no arms. rsc is the meta-harness that gives it both, plus the trade to know the… The licence is MIT.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 1f8d9bb. It shows what the files ask for, not the result of running them.
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.
Ships 1 file in scripts/ (Shell), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Market Research loads about 2.7k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 98 tokens; SKILL.md has 1,393 words of instructions outside code blocks.
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.
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.
The full file from ericrisco/rsc-harness at commit 1f8d9bb, republished under its MIT licence (© ericrisco). 1,393 words, ~2,724 tokens.
.claude/skills/market-research/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.You are the market-understanding engine. Someone hands you a fuzzy "is there a market for X?" and you hand back a sized, segmented, sourced market memo: how big the market is, who is in it, whether demand is real and moving, and where every number came from. Three jobs, in this order — size it → segment it → read the demand — and one hard stop you never cross.
The test of this work is not the number. It is whether someone else can audit the number. A $50B TAM you assert is a guess wearing a suit. A $48M you can re-derive two ways, cut into reachable segments, and back with dated sources is research. Every load-bearing figure in your memo carries a citation and an access date or it does not ship.
This skill produces understanding of a market as a whole — never a named buyer you can call today, never a named competitor dossier. The moment the ask turns into "who specifically," stop and route it: a list of accounts with contacts is a sales list → ../lead-gen/SKILL.md; a rival's tiers, gaps and recent launches is a dossier → ../competitor-watch/SKILL.md.
Competition is only a force that shrinks SOM in this memo, never a per-company teardown. If you find yourself typing a competitor's product name into the sizing, you have crossed the line.
| Job | One governing rule |
|---|---|
| Size it | Never ship a number without a second, independent method |
| Segment it | Cut by the job buyers hire you for, then prove the slice is reachable AND distinct |
| Read demand | Secondary to form the hypothesis, primary to decide it |
Do them in order — sizing tells you what to segment, segments tell you where to read demand. The artifact at the end ties all three together with a sources table.
Two instruments, two different errors. Run both and force them to agree.
| Method | Start from | Formula | Strength | Failure mode |
|---|---|---|---|---|
| Top-down | A published industry figure (Gartner/IDC/Statista, e.g. "$70B CRM market") | industry size × your segment share % | Fast, anchors to a named source | Inherits and amplifies the report's error; easy to hand-wave the share % |
| Bottom-up | Your customers + price | ACV × number of ICP-fitting accounts | Grounded in your own pricing; survives investor scrutiny | Slow; needs a real ICP and a real account count |
Triangulation is the credibility test, not the number itself. 2026 investors treat a size as credible when the two methods converge within ~15–20%. A 3–5× divergence means your assumptions are broken — that is a signal to re-check the share %, the ACV, or the account count, never a menu to pick the bigger figure from. Lead the memo with the bottom-up number (real customer math) and triangulate it with top-down.
Bad "TAM = $50B." # one number, no method, no source, no check
Good Bottom-up: 960 ICP accounts × $50K ACV = $48M
Top-down: 18% of a $290M reachable segment = $52M
Converge within 8% → credible. Lead with $48M.The funnel SAM ≈ 20% of TAM, SOM ≈ 10% of SAM is an illustrative example to defend, not a constant to assume. Derive SAM from your real reach (model, geography, language) and SOM from the competitive pressure and your sales capacity — then state why. Worked top-down and bottom-up calculations, the convergence math, the SAM-then-SOM derivation logic, and the full memo template with its sources/provenance schema live in references/sizing-playbook.md.
Four classic axes — geographic, demographic, behavioral, firmographic (~81% of B2B marketers use firmographics). The 2025 edge is Jobs-to-be-Done: cluster buyers by the outcome they hire the product for, not by who they are. The why is blunt — people buy outcomes, not demographics. Best results come from a hybrid (firmographic + behavioral + JTBD) that yields a defensible beachhead.
Name the beachhead — the one segment you win first. Then run every segment through this test before it earns a row in the memo:
A segment that fails "reachable" or "distinct" is a demographic, not a market.
Secondary and primary research answer different questions. Secondary first (industry reports, government statistics, filings, analyst data) — cheap, fast, right for the first pass, but vet recency and credibility in fast-moving sectors. Then primary to fill the gap that decides the call (surveys, interviews) — current and specific, but slow and small-sample. Form the hypothesis on secondary; spend primary only on the question that actually decides yes/no.
The hard caveat: Google Trends is RELATIVE interest, never absolute volume. Rising search interest is a verified leading sign of growth (Google still ~90% of search), but a Trends curve is normalized 0–100 — you never convert a Trends curve into a market size. Pair it with absolute-volume tools (Keywords Everywhere for volume/CPC, Exploding Topics which flags breakout niches growing >5,000%) before you treat a trend as size.
Bad "Search interest doubled on Google Trends → the market is $2B." # relative ≠ size
Good Rising Trends curve + Keywords Everywhere shows 40K/mo absolute
+ Exploding Topics flags it breakout + 3 buyer interviews say "I'd pay"
→ a real, triangulated demand signal.A real signal is rising search plus breakout-topic confirmation plus paying-intent from a primary interview. Vanity is one viral spike, a single curve, or a report with no date. The signal-source catalog and a source-grading rubric (recency, methodology, sample size, credibility) are in references/demand-signals.md.
Every market-research output has the same fixed shape so it can be audited and handed off:
This is exactly what scripts/verify.sh checks. Keep it Markdown so the linter can parse it.
| Bad | Good | Why |
|---|---|---|
| Ship one TAM number, no second method | Run top-down AND bottom-up, state the convergence | A lone figure is unfalsifiable; readers discount it |
| "$50B market" with no source or year | Cite the report + access date for every figure | Undated/unsourced = a guess; markets move fast |
| Top-down and bottom-up are 4× apart, pick the bigger | Re-check inputs until they converge ≤~20% | 3–5× divergence means broken assumptions, not a choice |
| Convert a Google Trends curve into a market size | Pair with absolute-volume tools before sizing | Trends is RELATIVE interest, never absolute volume |
| Segment by demographics alone | Add JTBD/behavioral; name a reachable beachhead | Demographics miss why people buy, and a market with no beachhead is one you can't enter |
| Treat SAM/SOM as fixed 20%/10% of TAM | Derive SAM from reach, SOM from competition + capacity | Those ratios are illustrative, not constants |
| Name specific competitor products in the memo | Treat competition as a SOM-shrinking force | A dossier is scope creep — hand to competitor-watch |
| List named target accounts as "the market" | Hand the segment to lead-gen to build the list | That is a sales list, not market understanding |
| All secondary data, no primary check on the decisive question | Use interviews/survey to fill the gap that decides | Stale or misaligned reports mislead the call — you just confirm your own bias |
The memo is a checkable artifact, so scripts/verify.sh lints a produced memo file (read-only — it never edits) for the three things above that keep "market sizing" honest: the numeric SOM ≤ SAM ≤ TAM nesting, both methods plus a stated convergence/divergence note (one method alone fails), and a citation and date on every load-bearing figure.
./scripts/verify.sh # scan ./ for *memo*/*market*.md
./scripts/verify.sh --path memo.md # check one memo
./scripts/verify.sh --path research/ # scan a directory of memos
./scripts/verify.sh --strict # treat warnings as failures (CI gate)It exits 0 on a clean or empty target — a missing memo is a skip, never a false failure.
The memo is the start of a chain. When it is done, route:
../pitch-deck/SKILL.md.../financial-model/SKILL.md.../lead-gen/SKILL.md.../competitor-watch/SKILL.md.../pricing/SKILL.md.../forecasting/SKILL.md.../content-engine/SKILL.md.© ericrisco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 5 other files (scripts, references) in skills/market-research of ericrisco/rsc-harness.
Open the folder on GitHubat commit 1f8d9bb
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Market Research this skillericrisco/rsc-harness | 180 | — | ~2.7k | Automated safety check: Pass | MIT | |
| Startup Designferdinandobons/startup-skill | 1.2k | — | ~8.1k | Automated safety check: Pass | MIT | |
| Market Research ReportsK-Dense-AI/claude-scientific-writer | 2.4k | 1 repos | ~3.5k | Automated safety check: Pass | MIT | |
| Market Research Analysismanojbajaj95/claude-gtm-plugin | 105 | — | ~2.6k | Automated safety check: Pass | MIT | |
| Product Strategistnicepkg/auto-company | 195 | 1 repos | ~2.4k | Automated safety check: Pass | None | |
| Market Researchshawnpang/startup-founder-skills | 343 | — | ~1.9k | Automated safety check: Pass | MIT |
ferdinandobons/startup-skill
Design, validate, and plan a startup from scratch. An agent skill from ferdinandobons/startup-skill.
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.
manojbajaj95/claude-gtm-plugin
Comprehensive market research and analysis skill. An agent skill from manojbajaj95/claude-gtm-plugin.
nicepkg/auto-company
Expert product strategy covering market analysis, competitive positioning, go-to-market planning, and product-led growth.
shawnpang/startup-founder-skills
When the user needs to estimate market size, understand market dynamics, or validate that a market opportunity is large enough to pursue.
gustavscirulis/snapgrid
Deep market analysis for iOS/macOS apps including market sizing (TAM/SAM/SOM), growth trends, market maturity, entry barriers, distribution channels, and revenue potential.
ericrisco/rsc-harness
A skill your agent uses when designing or analyzing a controlled experiment — falsifiable hypothesis, sample size from an MDE, reading significance/CI/power, CUPED, or rescuing tests that won't go…
ericrisco/rsc-harness
A skill your agent uses when making a web UI conform to WCAG 2.2 Level AA — axe-core or Lighthouse a11y violations, keyboard operability, focus management, ARIA roles/names/live regions, contrast…
ericrisco/rsc-harness
A skill your agent uses when running or fixing paid acquisition on Google or Meta — campaign structure (Performance Max, Demand Gen, Search, Advantage+), platform-fit creative, budget/scaling rules…
ericrisco/rsc-harness
A skill your agent uses when measuring whether an LLM or agent system actually got better and gating merges on it: golden sets, fixing an inflated LLM-as-judge, scoring RAG (faithfulness, contextual…
ericrisco/rsc-harness
A skill your agent uses when a creative goal must become a finished media file: pick and order generative-media models per modality — AI voiceover, image-to-video clips, score — then glue them with…
ericrisco/rsc-harness
A skill your agent uses when instrumenting product or web analytics — GA4/PostHog SDK wiring, event taxonomy, funnels, double-counted events, consent gating, PII scrubbing.
A skill your agent uses when a MARKET as a whole needs a defensible picture — TAM/SAM/SOM sized top-down AND bottom-up until the two converge, cut into reachable segments with one named beachhead…. Market Research is an agent skill from ericrisco/rsc-harness. Use when a MARKET as a whole needs a defensible picture — TAM/SAM/SOM sized top-down AND bottom-up until the two converge, cut into reachable segments with one named beachhead, demand proven real, and a dated source behind every figure.
Market Research fits situations like: A MARKET as a whole needs a defensible picture — TAM/SAM/SOM sized top-down AND bottom-up until the two converge; cut into reachable segments with one named beachhead; demand proven real; A dated source behind every figure.
Run `npx skills add ericrisco/rsc-harness --skill market-research -a claude-code`. Or copy the skill folder (skills/market-research in ericrisco/rsc-harness) into .claude/skills/market-research in your project. Claude Code loads it when a task matches its description.
Run `npx skills add ericrisco/rsc-harness --skill market-research -a codex`. Or copy the skill folder (skills/market-research in ericrisco/rsc-harness) into .agents/skills/market-research in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ericrisco/rsc-harness --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.
Going by SKILL.md and its folder, Market Research needs a shell for the scripts in its folder. Our summary lists: A Bash shell.
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.
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.
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.
About 2.7k 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 2.2k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Market Research: Startup Design (ferdinandobons/startup-skill, 1.2k stars), Market Research Reports (K-Dense-AI/claude-scientific-writer, 2.4k stars), Market Research Analysis (manojbajaj95/claude-gtm-plugin, 105 stars) and Product Strategist (nicepkg/auto-company, 195 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
ericrisco (a GitHub user) maintains it in ericrisco/rsc-harness, which has 180 GitHub stars. The repository holds 233 skills in this directory. The repository was last updated on October 9, 2026.
Source: ericrisco/rsc-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.