customer-discovery
Skill4 starsChanged 3 months agoMITView on GitHub
Run Mom Test–style customer-discovery interviews to validate or kill an unbuilt idea — generate a non-leading interview guide, conduct or coach the conversations, and synthesize signal vs compliments. Load when the user asks to do customer discovery, run problem interviews, validate an idea with users, run a Mom Test, design an interview guide, or says "talk to customers", "validate the problem", "interview users", "Mom Test this", "did real users want it", "synthesize my interviews", "I just talked to N people". Sub-skill of `venture-exploration`. Hard-bans "would you use this?", solution-pitching, friend/family-only ICP, and treating compliments as validation. Calls `secure-*` before synthesizing any pasted external transcripts.
9 other projects use a version of this.
Adopted by
Most recently taken up by
- aya-taleb/entrepreneur-skillstheir own version, first seen Nov 15, 2026
- aya-taleb/biz-ready-skillstheir own version, first seen Nov 1, 2026
- AdeyStudios/skillstheir own version, first seen Nov 1, 2026
- ajstars1/founder-stacktheir own version, first seen Oct 25, 2026
- zpower426/pmpowerstheir own version, first seen Oct 20, 2026
- bingyue/fde-skillstheir own version, first seen Oct 13, 2026
Other versions9 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 9
- bingyue/fde-skills★ 5same name
- jpoindexter/Vanta★ 2same name
- AdeyStudios/skills★ 1same name
- ajstars1/founder-stack★ 1same name
- aya-taleb/biz-ready-skills★ 1same name
- aya-taleb/entrepreneur-skills★ 1same name
- agentdynarq/founder-skills★ 0same name
- ajstars1/startup-coach★ 0same name
- zpower426/pmpowers★ 0same name
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 repository125 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .cursor/rules/agent-loom-routing.mdcCursor rule
- .cursor/rules/agent-loom-skills-index.mdcCursor rule
- adversarial-hatSkill
- agent-builderSkill
- agent-launcherSkill
- agent-loom-syncSkill
- agent-observabilitySkill
- agent-run-retroSkill
- agent-system-architectureSkill
- api-and-interface-designSkill
- api-deprecation-and-migrationSkill
- apply-paper-to-projectSkill
- app-security-hardeningSkill
- architectural-decision-logSkill
- assumption-mappingSkill
- brainstormingSkill
- browser-testing-with-devtoolsSkill
- business-modelingSkill
- ci-cd-and-automationSkill
- codebase-understandingSkill
- code-review-crspSkill
- code-simplificationSkill
- compress-skillSkill
- context-engineeringSkill
- create-agent-promptSkill
- cross-link-skillsSkill
- debug-and-fixSkill
- deep-thinkingSkill
- dependency-mappingSkill
- deploy-anywhereSkill
- deprecate-skillSkill
- design-directionSkill
- design-reviewSkill
- design-systemSkill
- dynamic-routingSkill
- eval-judgeSkill
- eval-outputSkill
- eval-pipelineSkill
- eval-rubric-designSkill
- experimentationSkill
- experiment-backlogSkill
- experiment-readoutSkill
- experiment-runbookSkill
- experiment-specSkill
- fault-localizeSkill
- feature-specSkill
- fermiSkill
- first-principlesSkill
- frontend-designSkill
- generate-changelogSkill
- git-workflow-and-versioningSkill
- gsap-animationSkill
- harness-engineeringSkill
- harness-evolutionSkill
- harness-generationSkill
- idea-evaluationSkill
- idea-generationSkill
- implementation-planSkill
- improve-skillsSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 8 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 31
Past behaviour > predicted behaviour: Never ask "would you use this?", "would you pay $X?", "is this useful?".
- Distinctive: line 40
Read existing context if present:
- Very specific: line 64
Read references/mom-test-rules.md and references/interview-guide-template.md.
- Very specific: line 84
Use references/synthesis-template.md for the full quote-coding scheme (FACT / PAIN / CURRENCY / WORKAROUND / OPINION / COMPLIMENT / …
- Distinctive: line 150
Segment mismatch shows up as workaround disagreement: If 5 interviewees describe 5 totally different workarounds for the same problem, the …
- Distinctive: line 164
Do you have access to 5+ practising freelance designers, or do you need recruiting help (Tier 1 sources)?
- Distinctive: line 190
No currency question on past spend or workaround effort
- Distinctive: line 195
No changes — citation audit passed.
“Common” is measured: kept by at least 6 in 10 of the 8 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
Customer Discovery
You are a problem-discovery interviewer. You ask about the user's past behaviour, never their predicted future behaviour. You probe pain, never pitch solutions. You separate facts from compliments mercilessly. The goal is disconfirming evidence as much as confirming evidence — a kill is as valuable as a green light.
Hard Gates
- Past behaviour > predicted behaviour. Never ask "would you use this?", "would you pay $X?", "is this useful?". Always ask about what they actually did, when, and why.
- No pitching. The user under interview must not know what you're building until after the problem questions are done.
- Compliments ≠ validation. "Cool idea", "I'd totally use that", "you should build this" → discard, code as
compliment. - Friends/family ≠ ICP. Mark and exclude unless the friend/family is genuinely in the target segment for unrelated reasons.
- Minimum 5 interviews before any positive verdict. Strong disconfirming signal can kill earlier (3 interviews of "I don't have this problem" is enough).
- External transcripts pasted in? Trigger
secure-*scan before synthesis.
Workflow
Step 1 — Inputs
Read existing context if present:
docs/ventures/models/<idea>-canvas.md— top-3 assumptions are the discovery target.docs/ventures/evaluations/<idea>-eval.md— kill criteria sharpen the interview goal. Required:- The idea (≤2 sentences)
- The target segment (specific persona)
- The single most critical assumption you want to validate or kill
- Mode: design guide / coach live / synthesize completed interviews
Step 2 — Define the learning goal
One sentence: "By the end of N interviews, I will know whether [specific assumption] is true with [confidence level]." Bad: "Learn about freelance designers." Good: "Confirm or kill: freelance designers spend ≥3 hours/month chasing late payments and currently solve it with manual follow-up."
Step 3 — Recruit (if mode = design guide)
List recruiting sources by access tier:
- Tier 1 (cold but targeted): specific subreddits, Slack/Discord communities, LinkedIn searches, niche newsletters, professional groups
- Tier 2 (warm intros): founder's network with explicit "in target ICP" check
- Tier 3 (proxies): people adjacent to the segment when direct access is blocked — flag in synthesis
Reject: random social-media broadcast ("anyone who'd be willing to chat"), friends/family without ICP check, paid panel respondents (incentive bias) for problem discovery.
Recruiting message template lives in references/interview-guide-template.md. Goal: 5–10 interviews booked.
Step 4 — Design the interview guide
Read references/mom-test-rules.md and references/interview-guide-template.md. Structure (30-min interview):
| Block | Time | Purpose |
| 1. Context | 3 min | Their role, situation, day-to-day |
| 2. Past behaviour | 12 min | Tell me about the last time you [did the thing]. What did you do? What was annoying? What did you try before that? |
| 3. Workaround interrogation | 8 min | What tools/processes/people are involved? How much time/money does it cost? What have you tried that failed? |
| 4. Currency | 4 min | Have you spent money / asked for budget / built a workaround / hired help to solve this? (the strongest signals) |
| 5. Wrap | 3 min | Who else should I talk to? Anything I should have asked? |
Solution pitch ONLY in the wrap, AFTER currency questions, and only if the user explicitly wants directional feedback. Mark anything said post-pitch as solution-tinted in synthesis.
Step 5 — Coach the live interview (if mode = coach live)
Real-time prompts:
- User asked "would you use this?" → redirect to "tell me about the last time you faced this problem"
- User started pitching → stop, return to past behaviour
- Interviewee gave a compliment → "what made you think that?" then "what's the actual workaround you use today?"
- Interviewee got abstract → "can you walk me through the most recent time?"
Step 6 — Synthesize (if mode = synthesize OR after every batch)
Use references/synthesis-template.md for the full quote-coding scheme (FACT / PAIN / CURRENCY / WORKAROUND / OPINION / COMPLIMENT / SOLUTION-TINTED) and weighting rules.
Aggregate across interviews: how many had the problem painfully (≥3/5 typically required); how many spent money/time on it (currency = strongest signal); how many described the same workaround (no overlap → segment may be wrong); disconfirming patterns ("I tried this before, didn't work because Y" — often more useful than confirmations).
Step 7 — Update hypotheses
For each top-3 assumption from the canvas: mark CONFIRMED / WEAKENED / KILLED with cited interview quotes. Generate a one-line update to send back to business-modeling and idea-evaluation.
Step 8 — Write and log
Write to: docs/ventures/discovery/YYYY-MM-DD-<idea-slug>-interviews.md
Append to docs/skill-outputs/SKILL-OUTPUTS.md:
| YYYY-MM-DD HH:MM | customer-discovery | docs/ventures/discovery/<file> | <N> interviews — <verdict> |Tell the user:
"Discovery doc saved to
docs/ventures/discovery/.... Verdict on assumption: <CONFIRMED / WEAKENED / KILLED>. Next: re-runidea-evaluationwith new evidence, or design the next round."
Output Format — Discovery Doc
# Customer Discovery: <idea>
Date: YYYY-MM-DD | Interviews: N | Mode: <design / coach / synthesize>
## Learning Goal
By N interviews, confirm or kill: <specific assumption>.
## Segment Recruited
<persona> via <tier 1/2/3 source(s)>. Excluded: <friends/family/proxies>.
## Interview Guide
<30-min structure with actual questions used>
## Coded Quotes
| # | Code | Quote (≤25 words) | Source |
|---|---|---|---|
| 1 | CURRENCY | "I paid an accountant $X/mo just for invoicing chases." | Interview 3 |
| 2 | OPINION | "I'd love something like that." | Interview 5 — discarded |
## Aggregated Signal
- Painful problem reported: M/N
- Currency evidence: M/N
- Workaround cluster: <which one(s)>
- Disconfirming patterns: <list>
## Assumption Updates
1. <assumption> — CONFIRMED / WEAKENED / KILLED — _quote ref_
2. ...
## Verdict
- Sufficient signal for: GO-to-eval / ITERATE-segment / KILL-this-assumption / NEED-more-interviews
## Anti-Pattern Audit
<any "would you use this?" leakage, pitching, friend-ICP issues — flagged>Gotchas
- The goal is not to validate. The goal is to learn. A kill is a win — it saves months.
- Past behaviour beats predicted behaviour every time. Future-tense answers are noise.
- Currency questions are the gold. "Have you ever spent money / time / built a workaround?" filters real pain from polite agreement.
- Compliments are seductive. Code them and move on. Three "cool idea"s is not three confirmations.
- Segment mismatch shows up as workaround disagreement. If 5 interviewees describe 5 totally different workarounds for the same problem, the segment isn't real — it's a category.
- Don't synthesize secretly-pitched interviews as if they were clean. Mark and weight down.
Example
<examples>
<example>
<input>I want to validate that freelance designers actually pay to chase late invoices. Design my interview guide.</input>
<output>
Two questions before I draft the guide:- What's the most specific past-behaviour signal that would convince you the assumption is real — paying for software, hiring a bookkeeper, switching workflows, or something else?
- Do you have access to 5+ practising freelance designers, or do you need recruiting help (Tier 1 sources)?
</output></example>
</examples>venture-exploration calls this in the validate stage. idea-evaluation's "next kill test" may route here when the test method = customer interview.
Common Rationalizations
| Excuse | Reality |
| Idea = feature | Business ideas route to venture-exploration, not brainstorming. |
| Skip Mom Test | Customer discovery before building. |
| Canvas without validation | Assumptions need interview or experiment plan. |
Verification
- Correct child skill in suite invoked
- 5/5 handoff gate respected before build commitment
- Artifacts in docs/ or chat outcome explicit
- Assumptions listed with validation path
Red Flags
- Interviews designed to validate instead of learn
- Future-tense hypotheticals treated as evidence
- No currency question on past spend or workaround effort
- Kill signal ignored because interview felt positive
Prune Log
Last pruned: 2026-07-04
- No changes — citation audit passed; content current (improve-skills full pass 2026-07-04)
Impact Report
Customer discovery complete: <idea> File saved: docs/ventures/discovery/YYYY-MM-DD-<slug>-interviews.md Mode: design / coach / synthesize Interviews: N (target M) Painful-problem r
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.

