@veyralabs/skills 0.4.1 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # VeyraSkills
2
2
 
3
- ![7 skills](https://img.shields.io/badge/skills-7-blue) ![npm](https://img.shields.io/npm/v/@veyralabs/skills) ![license](https://img.shields.io/badge/license-MIT-green)
3
+ ![8 skills](https://img.shields.io/badge/skills-8-blue) ![npm](https://img.shields.io/npm/v/@veyralabs/skills) ![license](https://img.shields.io/badge/license-MIT-green)
4
4
 
5
5
  Skills for Claude Code and other AI coding agents. Each skill is a plain text file that teaches your agent a specialized workflow - naming, branding, website cloning, Shopify development, and more.
6
6
 
@@ -8,6 +8,7 @@ Skills for Claude Code and other AI coding agents. Each skill is a plain text fi
8
8
  npx @veyralabs/skills install naming-suite
9
9
  npx @veyralabs/skills install webcloner
10
10
  npx @veyralabs/skills install shopify-suite
11
+ npx @veyralabs/skills install venture-suite
11
12
  ```
12
13
 
13
14
  Or install everything at once:
@@ -42,6 +43,16 @@ Two skills covering the full Shopify stack - one for developers building themes
42
43
  | [shopify-dev](./skills/shopify-suite/shopify-dev/SKILL.md) | Shopify development across all layers: Liquid themes, JSON templates, app development with Remix, Storefront and Admin API, CLI workflows, checkout extensions, Hydrogen. Fetches live Shopify documentation via Context7 before answering version-sensitive questions |
43
44
  | [shopify-store](./skills/shopify-suite/shopify-store/SKILL.md) | Store audit and optimization. Works in two modes: Mode A uses shopify-mcp to read real store data (products, orders, apps, metafields); Mode B uses public extraction when MCP is not available. Audits 6 dimensions: catalog health, collection architecture, navigation, SEO, app stack, conversion signals |
44
45
 
46
+ ### venture-suite
47
+
48
+ Research a startup or SaaS idea before building. Collects evidence from HN, Reddit, GitHub, and web searches - no API keys required.
49
+
50
+ | Skill | What it does |
51
+ |-------|-------------|
52
+ | [venture-analyst](./skills/venture-suite/venture-analyst/SKILL.md) | Four-phase idea validation: problem discovery (evidence from real sources), competitor intelligence (pricing, gaps, weaknesses), validation experiments (Mom Test, fake door, concierge MVP), and a Bull/Bear/Judge verdict with confidence score |
53
+
54
+ Includes Python scripts for zero-key data collection and auto-detection of available enhancements (SearXNG via Docker, optional API keys). All methodology references included: Lean Startup, Customer Development, Mom Test, Blue Ocean Strategy, Traction.
55
+
45
56
  ### webcloner
46
57
 
47
58
  Clone any landing page, marketing site, portfolio, or ecommerce storefront into a pixel-accurate Next.js replica.
@@ -66,6 +77,8 @@ npx @veyralabs/skills install webcloner
66
77
  npx @veyralabs/skills install shopify-suite
67
78
  npx @veyralabs/skills install shopify-dev
68
79
  npx @veyralabs/skills install shopify-store
80
+ npx @veyralabs/skills install venture-suite
81
+ npx @veyralabs/skills install venture-analyst
69
82
  npx @veyralabs/skills install domainforge
70
83
  ```
71
84
 
@@ -144,6 +157,8 @@ Each skill is also published as a standalone npm package if you only want one:
144
157
  - `@veyralabs/shopify-suite`
145
158
  - `@veyralabs/shopify-dev`
146
159
  - `@veyralabs/shopify-store`
160
+ - `@veyralabs/venture-suite`
161
+ - `@veyralabs/venture-analyst`
147
162
 
148
163
  ---
149
164
 
package/bin/cli.js CHANGED
@@ -11,8 +11,9 @@ const COMMANDS_DIR = path.join(__dirname, '..', 'commands');
11
11
 
12
12
  // pip packages required per skill
13
13
  const SKILL_PIP_DEPS = {
14
- 'shopify-store': ['scrapling'],
15
- 'webcloner': ['scrapling'],
14
+ 'shopify-store': ['scrapling'],
15
+ 'webcloner': ['scrapling'],
16
+ 'venture-analyst': ['scrapling', 'ddgs', 'trendspyg', 'requests'],
16
17
  };
17
18
 
18
19
  const AGENT_PATHS = {
@@ -0,0 +1,16 @@
1
+ Activate the venture-analyst skill. Task: $ARGUMENTS
2
+
3
+ Read the full skill at skills/venture-suite/venture-analyst/SKILL.md before doing anything else.
4
+
5
+ Then run the 4 phases in order:
6
+
7
+ 1. Problem Discovery - collect evidence from HN, Reddit, GitHub, trends using scripts/sources.py
8
+ 2. Competitor Intelligence - map the landscape using scripts/scraper.py and sources
9
+ 3. Validation Experiments - generate prioritized experiments using scripts/experiments.py
10
+ 4. Verdict - Bull case, Bear case, Judge verdict using the scoring system in SKILL.md
11
+
12
+ Start by detecting environment enhancements silently (scripts/enhance_detect.py) and use the best available search method without asking the user for any API keys.
13
+
14
+ If the user did not specify the idea clearly, ask one question: "What's the idea, and who is it for?"
15
+
16
+ Output the full verdict using templates/verdict.md as structure.
package/install.sh CHANGED
@@ -118,6 +118,7 @@ check_deps() {
118
118
  declare -A SKILL_PIP_DEPS=(
119
119
  ["shopify-store"]="scrapling"
120
120
  ["webcloner"]="scrapling"
121
+ ["venture-analyst"]="scrapling ddgs trendspyg requests"
121
122
  )
122
123
 
123
124
  install_pip_deps() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@veyralabs/skills",
3
- "version": "0.4.1",
3
+ "version": "0.5.1",
4
4
  "description": "VeyraSkills — A curated collection of Claude Code skills for founders, developers and AI builders",
5
5
  "bin": {
6
6
  "veyraskills": "bin/cli.js"
@@ -35,7 +35,11 @@
35
35
  "shopify-theme",
36
36
  "shopify-app",
37
37
  "shopify-audit",
38
- "ecommerce"
38
+ "ecommerce",
39
+ "startup-validation",
40
+ "market-research",
41
+ "idea-validation",
42
+ "lean-startup"
39
43
  ],
40
44
  "author": "VeyraLabs <hello@veyralabs.com>",
41
45
  "license": "MIT",
@@ -0,0 +1,449 @@
1
+ ---
2
+ name: venture-analyst
3
+ description: Startup and SaaS idea validation. Researches market evidence, maps competitors, scores viability, and generates concrete validation experiments. Zero API keys required.
4
+ ---
5
+
6
+ # Venture Analyst
7
+
8
+ Research a startup or SaaS idea and determine if it's worth building. No fluff - real evidence from real sources, structured reasoning, and a committed decision.
9
+
10
+ ## What this does
11
+
12
+ Five phases, each producing structured output:
13
+
14
+ 1. **Problem Discovery** - Find evidence the problem actually exists (Reddit, HN, GitHub issues, trends)
15
+ 2. **Competitor Intelligence** - Map the landscape, find gaps, extract pricing signals
16
+ 3. **Validation Experiments** - Generate 3 prioritized experiments to test demand before building
17
+ 4. **Verdict** - Bull/Bear/Judge debate with Confidence Engine and scored recommendation
18
+ 5. **Decision Intelligence** - Contradiction detection, founder trap check, reality check, distribution plan, time-to-first-dollar
19
+
20
+ ## How to use
21
+
22
+ Describe your idea. Include:
23
+ - What it does (one sentence)
24
+ - Who it's for (target customer)
25
+ - What problem it solves
26
+
27
+ Optional: budget for experiments, market type (B2C/B2B), known competitors, founder background.
28
+
29
+ ## Phase 1 - Problem Discovery
30
+
31
+ **Goal:** Find evidence the problem is real and people talk about it unprompted.
32
+
33
+ Use `scripts/sources.py` to collect evidence:
34
+
35
+ ```python
36
+ from scripts.sources import search_hn, search_hn_comments, search_reddit, search_github_issues, get_trends, calculate_evidence_score
37
+
38
+ hn_stories = search_hn(query, limit=20)
39
+ hn_comments = search_hn_comments(query, min_points=3, limit=30)
40
+ reddit_posts = search_reddit(query, limit=25, timeframe="year")
41
+ gh_issues = search_github_issues(query, limit=20)
42
+ trend_data = get_trends(keyword)
43
+ ```
44
+
45
+ **Evidence Quality (not just quantity):**
46
+
47
+ Evaluate source mix and signal strength, not just raw counts.
48
+
49
+ | Source | Quality signal | Weight |
50
+ |--------|---------------|--------|
51
+ | HN Ask/Show with 50+ points | People actively seeking solutions | High |
52
+ | Reddit complaints with 100+ upvotes | Widespread frustration | High |
53
+ | GitHub issues with many reactions | Developers hitting the same wall | High |
54
+ | HN/Reddit mentions of spending money | Willingness to pay | Very high |
55
+ | Rising trend | Growing problem | High |
56
+ | Trend flat | Established problem | Medium |
57
+ | Trend declining | Dying problem | Negative |
58
+ | Generic blog posts | Low signal noise | Low |
59
+
60
+ Evidence Quality grades:
61
+ - **A** - Multiple high-quality sources, direct pain quotes, spending signals
62
+ - **B** - Good source mix, clear pain but limited spending signals
63
+ - **C** - Some signal but concentrated in one source
64
+ - **D** - Thin signal, only indirect evidence
65
+ - **F** - Essentially no evidence
66
+
67
+ **Synthesize findings:**
68
+
69
+ Strongest pain signals (prioritize):
70
+ - People actively spending money on imperfect solutions
71
+ - Recurring complaints with no satisfying answer
72
+ - "Is there a tool that does X?" posts with many upvotes
73
+ - GitHub issues with many reactions, still open
74
+
75
+ Red flags:
76
+ - Zero discussion anywhere (even if search terms varied)
77
+ - Problem exists but everyone's workaround is "good enough"
78
+ - Only a few power users care, no broad market
79
+ - Discussion peaked years ago (dying category)
80
+
81
+ **Output format:**
82
+ ```
83
+ ## Problem Evidence
84
+
85
+ Evidence Score: [0-100]
86
+ Evidence Quality: [A/B/C/D/F]
87
+
88
+ Source breakdown:
89
+ - HN: [n] discussions, strongest: "[quote]"
90
+ - Reddit: [n] posts, strongest: "[quote]"
91
+ - GitHub: [n] issues, strongest reaction count: [n]
92
+ - Trend: [rising/stable/declining], avg interest: [n]
93
+
94
+ Quality notes:
95
+ - [what makes this evidence strong]
96
+ - [what's missing]
97
+ ```
98
+
99
+ ## Phase 2 - Competitor Intelligence
100
+
101
+ **Goal:** Map who's already solving this. Find pricing, positioning gaps, weak points.
102
+
103
+ ```python
104
+ from scripts.scraper import scrape_competitor
105
+ from scripts.sources import search_github_repos, search_web
106
+
107
+ repos = search_github_repos(f"{idea} tool", limit=8)
108
+ web_results = search_web(f"{idea} software alternatives", limit=8)
109
+
110
+ for url in competitor_urls:
111
+ data = scrape_competitor(url)
112
+ # data: title, tagline, description, pricing, features, tech_stack
113
+ ```
114
+
115
+ **Competitive map:**
116
+ ```
117
+ | Name | Pricing | Target | Weakness | Stars/Users |
118
+ |------|---------|--------|----------|-------------|
119
+ ```
120
+
121
+ **Gaps to identify:**
122
+ - Price ceiling: tier missing between free and enterprise?
123
+ - Audience gap: power users vs beginners vs enterprise underserved?
124
+ - Feature gap: what do reviews complain about repeatedly?
125
+ - Distribution gap: channel nobody is using?
126
+
127
+ **Opportunity Score vs Startup Score:**
128
+
129
+ These are two different things. Conflating them is a common mistake.
130
+
131
+ - **Opportunity Score** = how good is the market? (demand, size, willingness to pay)
132
+ - **Startup Score** = how viable is this as a startup? (scalability, defensibility, execution path)
133
+
134
+ A market can be huge (high opportunity) but impossible to win as a bootstrapped startup (low startup score). Example: "A better Stripe" - huge opportunity, near-zero startup score for most founders.
135
+
136
+ Score both separately in the competitor output section.
137
+
138
+ ## Phase 3 - Validation Experiments
139
+
140
+ **Goal:** Before writing code, find out if people will actually pay.
141
+
142
+ ```python
143
+ from scripts.experiments import generate_experiments, format_experiment_output
144
+
145
+ experiments = generate_experiments(
146
+ idea=idea,
147
+ target_customer=target,
148
+ market_type="b2b", # or "b2c"
149
+ competition_level="medium",
150
+ budget="zero",
151
+ )
152
+ print(format_experiment_output(experiments, idea))
153
+ ```
154
+
155
+ Present experiments in priority order. Cheapest + highest-signal first.
156
+
157
+ **Mom Test enforcement** - when helping design interviews or outreach:
158
+ - See `references/mom-test.md` for good vs bad questions
159
+ - Flag any future-hypothetical question ("would you use X?")
160
+ - Replace with past-behavior questions ("how do you currently handle X?")
161
+
162
+ **Time-To-First-Dollar estimate:**
163
+
164
+ For each experiment path, estimate realistic time to first revenue:
165
+
166
+ | Market type | Typical range | What accelerates it |
167
+ |------------|--------------|---------------------|
168
+ | B2C consumer SaaS | 30-90 days | Viral loop, strong landing page CTR |
169
+ | B2B SMB | 30-60 days | Warm outreach, concierge MVP |
170
+ | B2B mid-market | 60-180 days | Champion inside company, ROI clear |
171
+ | B2B enterprise | 6-18 months | Do not start here without traction |
172
+ | Developer tool (paid) | 14-45 days | Show HN, Product Hunt, X/Twitter post |
173
+ | Marketplace | 90-180+ days | Cold start problem, both sides |
174
+ | Content-led SaaS | 60-120 days | SEO takes time, need existing audience |
175
+
176
+ This is not the time to build - it's the time from starting experiments to first paying customer.
177
+
178
+ ## Phase 4 - Verdict
179
+
180
+ **Goal:** Simulate a debate between Bull, Bear, and Judge. Reach a committed conclusion.
181
+
182
+ ### Confidence Engine
183
+
184
+ The confidence score must explain itself. Not "Confidence: High" alone. Show the reasoning.
185
+
186
+ ```
187
+ Confidence: [0-100]
188
+
189
+ High confidence because:
190
+ + [n] Reddit mentions across [n] subreddits
191
+ + [n] GitHub issues with [n]+ reactions
192
+ + [n] competitors validated with real pricing
193
+ + Rising trend over [period]
194
+ + [specific spending signal found]
195
+
196
+ Confidence reduced because:
197
+ - [specific gap, e.g. weak monetization signals]
198
+ - [e.g. no willingness-to-pay evidence found]
199
+ - [e.g. fragmented ICP - different pain in different segments]
200
+ - [e.g. limited search volume data]
201
+ ```
202
+
203
+ This matters because users need to see the reasoning is transparent, not magic.
204
+
205
+ ### Bull case (write this first)
206
+ - Strongest evidence for building it
207
+ - Market timing arguments
208
+ - Why this team / why now
209
+ - Best-case scenario with numbers
210
+
211
+ ### Bear case (steelman the opposition)
212
+ - Strongest evidence AGAINST building it
213
+ - Why existing solutions might be good enough
214
+ - Market risks, timing risks, competition risks
215
+ - Why it might fail even if the problem is real
216
+
217
+ ### Judge verdict
218
+
219
+ Apply these criteria:
220
+
221
+ | Signal | Weight |
222
+ |--------|--------|
223
+ | Evidence score > 60 | +2 |
224
+ | Evidence quality A or B | +1 |
225
+ | Trend = rising | +1 |
226
+ | Competitors have clear weakness | +1 |
227
+ | No dominant player (>50% market) | +1 |
228
+ | B2B with willingness-to-pay signals | +1 |
229
+ | Price ceiling exists | +1 |
230
+ | Evidence score < 30 | -3 |
231
+ | Evidence quality D or F | -2 |
232
+ | Trend = declining | -2 |
233
+ | 1+ competitor with >100k users + free tier | -2 |
234
+ | Problem is niche (<10k potential users) | -1 |
235
+ | Founder trap detected (high priority) | -2 |
236
+ | Reality check failed | -2 |
237
+
238
+ **Verdict:**
239
+ ```
240
+ Recommendation: BUILD / VALIDATE FIRST / AVOID
241
+ Confidence: [0-100]
242
+ Score: [+N or -N]
243
+
244
+ Judge's reasoning:
245
+ [2-3 sentences. Direct. No hedging. Reference the specific evidence that tipped the scale.]
246
+ ```
247
+
248
+ ## Phase 5 - Decision Intelligence
249
+
250
+ Run this after the Verdict. It does not change the verdict score - it adds context that makes the decision actionable.
251
+
252
+ ### Contradiction Detector
253
+
254
+ Look for contradictions between sources. The most valuable insight is often in the gap between what people say and what the market shows.
255
+
256
+ Common contradiction patterns:
257
+
258
+ **Pain high, market growing:**
259
+ ```
260
+ Reddit: strong complaints about current solutions
261
+ Competitors: growing, raising funding
262
+
263
+ Interpretation: users hate existing tools but still pay.
264
+ This is an improvement opportunity, not a replacement play.
265
+ Consider: better UX, better pricing, better ICP focus.
266
+ ```
267
+
268
+ **Pain high, no competitors:**
269
+ ```
270
+ Evidence of real pain.
271
+ Zero viable competitors found.
272
+
273
+ Two interpretations:
274
+ 1. Blue ocean - opportunity exists
275
+ 2. Graveyard - others tried and died
276
+
277
+ Check: search for failed startups in this space. If multiple failed,
278
+ investigate why before treating this as opportunity.
279
+ ```
280
+
281
+ **Trend rising, community silent:**
282
+ ```
283
+ Google Trends shows growing interest.
284
+ Reddit/HN have minimal discussion.
285
+
286
+ Possible: problem is new, community hasn't formed yet (early).
287
+ Risk: trend is noise, not genuine demand.
288
+ ```
289
+
290
+ **Competition dense, pain still high:**
291
+ ```
292
+ Multiple established competitors.
293
+ Pain signals still strong and recent.
294
+
295
+ Interpretation: nobody has actually solved it.
296
+ Look for the structural reason: price, UX, missing feature, wrong ICP.
297
+ ```
298
+
299
+ When a contradiction is found, output:
300
+ ```
301
+ Contradiction detected: [name]
302
+
303
+ [source A] shows: [signal]
304
+ [source B] shows: [signal]
305
+
306
+ Most likely interpretation: [explanation]
307
+ What to verify: [specific experiment or question that resolves this]
308
+ ```
309
+
310
+ ### Founder Trap Detector
311
+
312
+ Check `references/founder-traps.md` for full criteria.
313
+
314
+ Evaluate the evidence against each trap pattern. Flag any trap where 3+ signals match.
315
+
316
+ Output when trap found:
317
+ ```
318
+ Founder Trap: [trap name]
319
+ Evidence: [which signals matched]
320
+ Risk level: [high/medium]
321
+ Does not invalidate the opportunity, but changes the execution approach.
322
+ ```
323
+
324
+ ### Reality Check
325
+
326
+ This is not about the market - it's about whether this founder can execute this idea.
327
+
328
+ Gather context:
329
+ - What is the founder's background? (from idea description if mentioned)
330
+ - What does the idea require to work? (regulatory, infrastructure, capital, technical depth)
331
+
332
+ Questions to answer:
333
+ 1. Does this require compliance, licensing, or regulatory approval?
334
+ 2. Does this require partnerships before it can function? (e.g. bank partners, data licenses)
335
+ 3. Does this require enterprise sales from day one?
336
+ 4. Does this require a team of 10+ to build the MVP?
337
+ 5. Is the technical complexity beyond a solo founder?
338
+
339
+ If 2+ of these are true:
340
+ ```
341
+ Reality check: Execution path is high-risk for early-stage founders
342
+
343
+ Requires: [list what it requires]
344
+
345
+ This does not mean the opportunity is bad.
346
+ It means: do not start building until these constraints are addressed.
347
+
348
+ Alternative paths:
349
+ - [reduced scope version that avoids the constraint]
350
+ - [validate the demand first, then find the right co-founder/partner]
351
+ ```
352
+
353
+ ### Distribution Plan
354
+
355
+ Based on the research, recommend 3 specific acquisition channels.
356
+
357
+ Use `references/traction.md` for channel criteria. Apply to this specific market:
358
+
359
+ ```
360
+ Top channels for this idea:
361
+
362
+ 1. [channel] - because [specific evidence from research]
363
+ Test: [how to run a cheap test in 2 weeks]
364
+
365
+ 2. [channel] - because [specific evidence]
366
+ Test: [how to test]
367
+
368
+ 3. [channel] - because [specific evidence]
369
+ Test: [how to test]
370
+
371
+ Avoid:
372
+ - SEO - [reason, e.g. "competitive market, 6+ months to rank"]
373
+ - Paid social - [reason, e.g. "B2B ICP hard to target on Meta"]
374
+ ```
375
+
376
+ Do not recommend generic channels. Base it on where the pain evidence was actually found.
377
+
378
+ Example: if most Reddit signal came from r/smallbusiness, recommend Reddit community strategy specifically.
379
+
380
+ ### Time-To-First-Dollar
381
+
382
+ Based on the market type, competition, and experiment plan:
383
+
384
+ ```
385
+ Time-To-First-Dollar estimate: [X-Y weeks/months]
386
+
387
+ Path:
388
+ Week 1-2: [specific action, e.g. "cold outreach to 50 Reddit users who posted about problem"]
389
+ Week 3-4: [specific action]
390
+ Week 5-8: [specific action]
391
+ Target: first paying customer by [date estimate]
392
+
393
+ What would accelerate this: [specific factor]
394
+ What would delay this: [specific risk]
395
+ ```
396
+
397
+ ## Enhancement detection
398
+
399
+ Run at session start to unlock better sources:
400
+
401
+ ```python
402
+ from scripts.enhance_detect import detect_level, ensure_searxng, best_search
403
+
404
+ env = detect_level()
405
+ # Returns: docker, searxng, veyrascrape_mcp, github_token, exa_key, tavily_key, groq_key
406
+
407
+ if env["docker"] and not env["searxng"]:
408
+ ensure_searxng() # silent, no user prompt
409
+
410
+ results = best_search(query, env, limit=10)
411
+ ```
412
+
413
+ **Level 1 (always works):** HN + Reddit + GitHub + ddgs + trendspyg
414
+ **Level 2 (auto, no keys):** + SearXNG via Docker (if Docker installed)
415
+ **Level 3 (optional keys):** + Exa, Tavily, GitHub authenticated, VeyraScrape MCP
416
+
417
+ Never ask the user to set up API keys. Auto-detect and use what's available.
418
+
419
+ ## Evidence Score interpretation
420
+
421
+ From `calculate_evidence_score()` in `sources.py`:
422
+
423
+ | Score | Meaning |
424
+ |-------|---------|
425
+ | 0-20 | Weak - barely any signal. Rethink or pivot problem framing |
426
+ | 21-40 | Thin - some signal but not convincing |
427
+ | 41-60 | Moderate - proceed to competitor research |
428
+ | 61-80 | Strong - real problem, real people care |
429
+ | 81-100 | Very strong - validated pain, move to experiments immediately |
430
+
431
+ ## Methodology references
432
+
433
+ - `references/lean-startup.md` - validated learning, MVP types, pivot signals
434
+ - `references/customer-dev.md` - Steve Blank's 4 steps, problem interview structure
435
+ - `references/mom-test.md` - good vs bad interview questions
436
+ - `references/blue-ocean.md` - Value Curve, ERRC Grid, finding uncontested space
437
+ - `references/traction.md` - 19 acquisition channels, Bullseye framework
438
+ - `references/founder-traps.md` - 8 trap patterns with evidence criteria
439
+
440
+ ## Output principles
441
+
442
+ 1. Lead with evidence, not opinions
443
+ 2. Quote real sources (HN post, Reddit thread, GitHub issue) with specifics
444
+ 3. Separate fact from inference - never present interpretation as data
445
+ 4. Show the Confidence Engine reasoning - never just state "High confidence"
446
+ 5. Run the contradiction check - the most valuable insight is often in the gaps
447
+ 6. Check for founder traps before finalizing verdict
448
+ 7. Verdict must commit - no "it depends" without specifics and a path forward
449
+ 8. Distinguish Opportunity Score from Startup Score
@@ -0,0 +1,130 @@
1
+ # Blue Ocean Strategy Reference
2
+
3
+ W. Chan Kim & Renee Mauborgne, "Blue Ocean Strategy" (2005, updated 2015).
4
+
5
+ ## Core concept
6
+
7
+ **Red Ocean:** existing market space. Competitors fight over same customers. Bloody from competition.
8
+ **Blue Ocean:** new market space. Create demand, not fight for it.
9
+
10
+ The goal: don't compete where everyone else is. Find (or create) a space where there's no direct competition.
11
+
12
+ This is not about being "different" for its own sake. It's about finding where existing solutions fail enough customers that a new approach can win without fighting incumbents.
13
+
14
+ ## Value Innovation
15
+
16
+ The foundation of blue ocean strategy. The simultaneous pursuit of:
17
+ - **Differentiation** (more value for customers) AND
18
+ - **Low cost** (lower cost to deliver)
19
+
20
+ Most companies choose one. Blue ocean does both by eliminating or reducing what the industry assumes is necessary.
21
+
22
+ Key: value innovation redefines what value means — it doesn't just add more features.
23
+
24
+ ## Value Curve
25
+
26
+ A visual tool. X-axis: factors the industry competes on. Y-axis: level of investment/offering.
27
+
28
+ Draw your value curve vs competitors:
29
+ 1. List all factors the industry competes on (price, features, quality, support, speed, etc.)
30
+ 2. Score each player 1-10 on each factor
31
+ 3. Connect the dots — that's the value curve
32
+
33
+ **What to look for:**
34
+ - Where are all competitors converging? (where you can differentiate)
35
+ - Where is investment high but customers don't care? (where you can eliminate/reduce)
36
+ - What do customers want that nobody offers? (where you can create/raise)
37
+
38
+ **Signs of a blue ocean opportunity:**
39
+ - Your curve looks completely different from competitors
40
+ - You're investing in factors they don't even measure
41
+ - You're not competing on any factor they compete on
42
+
43
+ ## ERRC Grid
44
+
45
+ The strategic tool for creating a new value curve.
46
+
47
+ | Action | Question | Why |
48
+ |--------|----------|-----|
49
+ | **Eliminate** | Which factors the industry takes for granted can be eliminated? | Remove cost + complexity customers don't value |
50
+ | **Reduce** | Which factors should be reduced well below the industry standard? | Stop over-delivering where it doesn't matter |
51
+ | **Raise** | Which factors should be raised well above the industry standard? | Solve what customers complain about |
52
+ | **Create** | Which factors should be created that the industry has never offered? | Add new value that opens new demand |
53
+
54
+ **How to use it for venture analysis:**
55
+
56
+ Look at the competitor landscape from Phase 2. Fill the ERRC grid:
57
+ - What do all competitors force customers to deal with? (Eliminate candidates)
58
+ - Where are they all investing heavily but customers complain anyway? (Reduce candidates)
59
+ - What do all G2/Reddit reviews say is missing? (Raise or Create candidates)
60
+
61
+ ## Three tiers of non-customers
62
+
63
+ Incumbents focus on existing customers. Blue ocean looks at non-customers:
64
+
65
+ **Tier 1 — "Soon-to-be" non-customers**
66
+ On the edge of the market. Use existing solutions but reluctantly. Would switch if something better existed.
67
+ - Find them: people who use tools but post complaints
68
+ - Signal: "I use X but I hate Y"
69
+
70
+ **Tier 2 — "Refusing" non-customers**
71
+ Consciously choose not to use existing solutions. Have the problem but handle it differently.
72
+ - Find them: "I could use X but I just [workaround] instead"
73
+ - Signal: "I tried X but gave up because..."
74
+
75
+ **Tier 3 — "Unexplored" non-customers**
76
+ Never considered as customers. In other markets or segments entirely.
77
+ - Find them: unexpected users of adjacent tools
78
+ - Signal: people solving your problem with tools not built for it
79
+
80
+ ## Red vs Blue Ocean signals in research
81
+
82
+ When analyzing a market, these signals matter:
83
+
84
+ ### Red Ocean signals (hard fight ahead)
85
+ - 5+ competitors with similar positioning and pricing
86
+ - Dominant player with >50% market share
87
+ - Feature comparison tables are the main marketing tool
88
+ - Price is primary differentiator
89
+ - High churn across all players (no moat)
90
+ - Reddit/HN: "X vs Y vs Z" comparison posts everywhere
91
+
92
+ ### Blue Ocean signals (opportunity)
93
+ - People solve the problem with spreadsheets or manual processes
94
+ - Niche community uses a tool far outside its intended purpose
95
+ - The "best" solution is widely criticized for the same thing
96
+ - Large group adjacent to current market who never adopted it
97
+ - Incumbents focused on enterprise; SMB underserved (or vice versa)
98
+ - Technology shift makes old assumptions invalid (mobile, AI, etc.)
99
+
100
+ ## Applying Blue Ocean to competitive analysis
101
+
102
+ In Phase 2, after mapping competitors, ask:
103
+
104
+ 1. **Which axis can you ignore entirely?**
105
+ - E.g., all competitors compete on features — can you win on simplicity instead?
106
+
107
+ 2. **What do customers actually use vs what they pay for?**
108
+ - If pricing is based on features but customers only use 20% of them, price simplicity
109
+
110
+ 3. **What's the "tax" on using existing solutions?**
111
+ - Setup time, training required, integrations needed, contracts, support tickets
112
+ - Eliminate the tax
113
+
114
+ 4. **Who's locked out of the market?**
115
+ - High price, high complexity, enterprise-only contracts
116
+ - If you can serve them, they're Tier 2/3 non-customers
117
+
118
+ ## Value Curve template
119
+
120
+ ```
121
+ Factor | Competitor A | Competitor B | Our position
122
+ ----------------|-------------|-------------|-------------
123
+ Price | High | Medium | ?
124
+ Ease of setup | Hard | Hard | ?
125
+ Feature breadth | Wide | Wide | ?
126
+ Support | Good | Poor | ?
127
+ [key factor] | ... | ... | ?
128
+ ```
129
+
130
+ A good blue ocean position looks different from all others — not just slightly better.