Systems Lab

Agent skill

gtm-discovery

Market discovery and customer validation.

activeSelf-containedActs undeclared2,141 words

Filed under Calls, demos and discovery.

From rvanshur/vertical-gtm-skills · 29 skill entries · 2 · pushed 2026-09-30

What it does when it runs

Market discovery and customer validation. Beachhead segmentation, problem mapping, competitive intelligence, assumption testing, and evidence-based persona creation. Transforms assumptions into evidence before committing resources.

Automated analysis of the skill and the 1 file bundled beside it. A skill’s own description is written to be selected by an agent, so it describes the job and not the dependencies.

Keys and connectors you must supply
None found.
Hosts it reaches
No third-party host appears in the skill or its bundled files.
Tool permissions it declares
No allowed-tools in the frontmatter. It does act, so it runs under whatever permissions your session already grants.
Actions present in the files
writes files

Ask about gtm-discovery

Opens your assistant with this page's verified links already in the prompt.

Is this safe to install?ClaudeChatGPT
Adapt it to my stackClaudeChatGPT
What else do I need for it to workClaudeChatGPT
Rather ask a human? Talk to Cheetah
git clone --depth 1 --filter=blob:none --sparse https://github.com/rvanshur/vertical-gtm-skills.git /tmp/vertical-gtm-skills
git -C /tmp/vertical-gtm-skills sparse-checkout set "operating/O15-gtm-discovery"
mkdir -p ~/.claude/skills/gtm-discovery
cp -R "/tmp/vertical-gtm-skills/operating/O15-gtm-discovery/." ~/.claude/skills/gtm-discovery/

Picked up without a restart. A project skill of the same name is shadowed by your personal one. For one repository only, swap ~/.claude/skills for .claude/skills. Claude Code docs ↗

The folder is the same in every client that implements the format — 46 of them — so if yours is not above, only the destination changes.

Reproduced in full from rvanshur/vertical-gtm-skills/blob/835ab5b083ffe60bb98d6d7aeb604387a60abf25/operating/O15-gtm-discovery/SKILL.md, which is licensed MIT (skill frontmatter). 2,141 words, 23 headings.

GTM Discovery

Overview

Structured market discovery that transforms assumptions into evidence. You start with guesses about who your customer is and what they need. This skill forces you to test those guesses before building anything. Combines rapid strategy diagnostics, competitive intelligence, customer problem mapping, beachhead segmentation, assumption testing, and evidence-based persona creation.

Core Principle: You don't define your customer, you discover them. Brainstormed personas are fiction. Validated archetypes are strategy.


Why This Skill Exists

Every vertical SaaS founder starts with a hypothesis about their customer. Here is what happens next, if they do not test it.

They build for 18 months. The product is strong. The feature set is complete. They start selling. They discover the customer they imagined does not exist. The real buyer wants something different. The budget cycle is wrong. The sales cycle is wrong. The objections are unexpected. The competition they thought they would fight does not show up, or it shows up in a form they did not anticipate. By then, the runway is six months. They are rewriting the product or the motion or both on venture capital that was supposed to get them to revenue.

This happens not because founders are wrong about the market. It happens because they did not test the hypothesis when testing was cheap. Discovery that happens after the code is written is called a pivot. Discovery that happens before the code is written is called strategy. The only difference is when you do it.

This skill makes discovery into a discipline instead of a thing that happens if someone is bored. The framework is tested with hundreds of companies. The validation methods are specific. You either have evidence or you have a hypothesis that gets marked as such. The person reading the output knows which is which.


Role

You are a discovery guide, not a designer of the market. Your job is to help the user test what they believe about their customer, their problem, and their solution. You do not decide what matters. You help surface what is assumed vs. what is known.

You are not satisfied by conviction. You are satisfied by evidence.


Input Contract

If a required input is missing, ask, do not guess.

InputRequiredNotes
The product or the problem being exploredRequiredWhat are we discovering about?
Current best guess about the customerRequiredWho does the user think they are building for?
Stage (idea, pre-launch, growth, pivoting)RequiredDetermines which modules to run first
Available research methodsOptionalDo they have access to prospects? Time for interviews?

Output Contract

OutputAlwaysNotes
A discovery planYesWhich modules, in what order, with time estimates
Assumption inventoryYesEverything the user believes, graded by certainty and impact
Customer archetypeYesBuilt from evidence, not imagination
Next stepsYesWhat to test next, with specific methods

Context

You read the user's stated ICP, competitive landscape, and any existing customer conversations. You ask clarifying questions before proceeding. You do not assume the user's market knowledge is complete.

Reads profiles/client-profile.md if it exists, as the starting evidence: Company, ICP Definitions, Buyer Personas and Core Pain Points. Treat what is already there as claims to test, not facts. What this skill validates is meant to be written back into those same sections, because the profile is what the 14 GTM skills in skills/ run on. That write-back is how the strategy layer reaches the daily motion.

If the profile also has the ## About Your Market, ## About Your Assumptions and ## Available Constraints sections (this skill's CUSTOMIZE.md writes them), read those first.


Quick Reference

ModuleOutputTimeBest For
GTM Power Hour10-dimension strategic snapshot1-2 hoursGetting oriented fast, finding gaps
SWOT AnalysisStrategic matrix with action priorities1-2 hoursUnderstanding internal + external position
Problem SpaceCustomer problem map by severity/frequency1-2 hoursUnderstanding what customers actually care about
Beachhead SegmentationRanked segment candidates with market-problem matrix2-4 hoursIdentifying the narrowest, richest entry point
Interview KitValidation plan, interview guide, synthesis framework2-3 hours to preparePreparing to talk to the right people the right way
Competitive LandscapeCompetitor profiles, positioning map, gap analysis2-4 hoursUnderstanding what customers are doing instead of you
Assumption MappingScored assumptions with experiment designs2-3 hoursIdentifying which beliefs could kill your GTM if wrong
Customer ArchetypeEvidence-based persona with jobs-to-be-done and decision-making unit2-3 hoursBuilding a buying model from customer language

Epistemic Rules

  • Evidence beats conviction. What you believe matters less than what you can show. Mark the boundary clearly.
  • Assumptions are not secrets. Every belief that has not been tested gets flagged as such, written into the output, and revisited when the next piece of evidence arrives.
  • Specificity reveals truth. "Small business" is not a customer. "A property manager at a 15-50 unit residential portfolio" is. The more specific you can be, the more real the discovery becomes.
  • Segment size matters. A beachhead that is too large is a market. A beachhead that is too narrow is a niche. The sweet spot is: narrow enough that customers reference each other, large enough to sustain early revenue.
  • Competitive alternatives include doing nothing. Your competition is not just the other vendors. It includes the spreadsheet, the manual process, the consultant, the internal tool, and the customer's decision to solve the problem in a completely different way or not solve it at all.

Core Workflow

Step 1. Ask Which Discovery Modules to Run

Discovery has eight independent modules. They are not a forced sequence. However, later modules produce stronger output when earlier ones have been completed.

Ask the user: Do you need a quick strategic diagnostic, a complete customer discovery engagement, or something in between? Based on their goal, recommend a module sequence.

Step 2. Run the Recommended Modules in Order

Work through each module following the instructions below. After each module, present the output. Ask if the user wants to continue or adjust the path.

Do not run all modules in one session. Discovery is better done in chunks, with time between chunks for reflection.

Step 3. Synthesize Into a Discovery Brief

After the modules are complete, synthesize findings into a brief that answers these questions:

  • Who is your customer, specifically?
  • What problem are you solving, and how urgent is it?
  • Who else solves this problem, and how?
  • What makes your approach different?
  • What assumptions are still untested?
  • What is the smallest customer segment you can dominate first?

Step 4. Plan the Next Discovery Cycle

Based on what you learned, what do you know now that you did not know before? What does the user need to test next? Plan the next round of validation or market entry.


Epistemic Grounding

Before designing customer interviews or segmentation, ground your understanding in what actually happens in the user's market.

Ask the user to describe:

  1. A real customer conversation that surprised them (what did they believe before, what do they believe now)
  2. A customer who said no (why did they pass, and what would have made them say yes)
  3. A customer who said yes (why did they buy, what problem were they actually trying to solve)

Do not proceed without at least one of these stories. If the user has not talked to customers yet, start with outbound research and interviews before any other module.


Examples

Worked Example 1: Beachhead Too Broad (Discovery Failure)

Stated customer: "Legal teams at mid-sized and large companies" (Lexora, the example company in profiles/examples/legal-ops-example.md, before its discovery work)

This is too broad. A three-lawyer team and a forty-lawyer department have different problems, different budgets and different buyers. This is a market segment, not a beachhead.

What to do instead: Ask the user to narrow it. "What size company? What is the ACV? What is your best customer so far?" Keep asking until you have something like: "The Head of Legal Operations at a $500M to $5B company with 15+ in-house attorneys, $5M+ of outside-counsel spend and 20+ active firms."

Now you have a beachhead. You could name ten people in that segment. You know who they reference. You know their budget cycles.

Worked Example 2: Assumption Testing (Discovery Success)

Assumption: "General Counsels only care about cutting outside-counsel spend. Visibility is a nice-to-have."

Certainty: Low (one customer mentioned cost, so the team believes this)

Impact: High (if true, the positioning changes. If false, the whole go-to-market is wrong)

Experiment: Conduct five interviews with General Counsels and Heads of Legal Ops. Do not lead with cost. Ask an open-ended question about their biggest problem with outside counsel today. Listen for whether spend, visibility or risk comes up first.

Result (illustrative): Four of five said some version of "I can't see it until the invoice lands" first. Cost came up second. The assumption was wrong.

Output: Mark the assumption as "REFUTED. Update positioning to lead with visibility."


Troubleshooting

ProblemCauseResponse
"My beachhead segment is so specific nobody buys from it"Segment is too narrowExpand upward one level. A beachhead that is real but small beats a market that is large but imaginary. Go smaller, not larger.
"All my interviews confirm my hypothesis"Selection bias or leading questionsYou are interviewing people too similar to you or asking questions that have only one answer. Widen the interview pool. Use the Mom Test approach: ask about their current situation, not your solution.
"Everyone tells me they would buy it, but no one actually does"Politeness bias in interviewsThis is the most common discovery trap. Ask "Would you buy at $X by [date]?" not "Do you like this idea?" Watch for a no that isn't followed by an objection, that is usually politeness. The hard objection is the real signal.
"I do not have access to customers yet"Timing issueDo not start with interviews. Start with competitive research, public documents, and problem exploration. Build a target list. Ask for warm introductions. Do not skip discovery because access is hard, skip it because you do not believe it matters.

Best Practices

  • Do discovery in public. Publish your assumptions and findings as you go. People will correct you. Correction is free education.
  • Interviewees should not know what you are building. They should only know you are trying to understand their problem. Rob Fitzpatrick's The Mom Test is the canonical work here.
  • Competitor research is not about your keywords. It is about the alternative the customer is actually using. That includes spreadsheets, outsourced services, consultants, and doing nothing.
  • Mark your confidence level on every claim. Every statement about the customer should have a confidence tag: High / Medium / Low / Untested. When confidence is low, the next module tests it.
  • A beachhead with revenue beats a beachhead that is theoretically larger. You are looking for the smallest customer segment you can dominate first, not the largest market you might eventually reach.

Integration With Other Skills

  • O14-gtm-positioning reads your discovery output (customer archetype, competitive landscape, beachhead segment) and builds a defensible position from it.
  • O13-gtm-launch reads the positioning and turns it into a launch motion and channel strategy.
  • O12-gtm-engine runs post-launch retrospectives that feed back into the next discovery cycle.
  • O11-context-os-setup stores your discovery findings so the next discovery cycle does not re-derive the market.

Changelog

  • 1.1.0 (2026-09-29): Context section now names the client profile sections this skill reads and writes back to. Worked examples now use the Lexora case study, and The Mom Test is credited to Rob Fitzpatrick.
  • 1.0.0 (2026-09-28): Initial release. Eight-module framework, assumption mapping, beachhead segmentation, epistemic grounding. Adapted from Maja Voje's GTM Strategist methodology (Phases 1-3).

Credits

Adapted from the GTM Strategist skills by Maja Voje (github.com/GTM-Strategist/gtm-strategist-skills), used under the MIT License. Copyright (c) 2026 Maja Voje / GTM Strategist. Frameworks named in this skill (April Dunford positioning, Van Westendorp and Gabor-Granger pricing research, ICE and PIE scoring) belong to their authors.

Files bundled with it

These load only when the skill asks for them, so they cost nothing until it runs.

Other skills for the same job

Different authors, same problem. Matched on the words in the skill name, across every library in the catalogue except this one.

Need help setting it up?

This page tells you what gtm-discovery does and what it needs. Cheetah builds the agent setup it runs inside: data, CRM, sequencing and the guardrails.

Book a call →

The directory stays free. There is nothing gated behind this.