startup-review-mining

THE GOLD MINE: Systematic extraction of pain points, feature gaps, switching triggers, and opportunities from ALL review sources (G2, Capterra, TrustRadius, App Store, Play Store, Reddit, Hacker News, Twitter/X, ProductHunt, GitHub Issues, support forums). Goes beyond UI/UX to cover pricing friction, support failures, integration nightmares, and value gaps.

$ 설치

git clone https://github.com/vasilyu1983/AI-Agents-public /tmp/AI-Agents-public && cp -r /tmp/AI-Agents-public/frameworks/claude-code-kit/framework/skills/startup-review-mining ~/.claude/skills/AI-Agents-public

// tip: Run this command in your terminal to install the skill


name: startup-review-mining description: > THE GOLD MINE: Systematic extraction of pain points, feature gaps, switching triggers, and opportunities from ALL review sources (G2, Capterra, TrustRadius, App Store, Play Store, Reddit, Hacker News, Twitter/X, ProductHunt, GitHub Issues, support forums). Goes beyond UI/UX to cover pricing friction, support failures, integration nightmares, and value gaps.

Review Mining Skill - The Gold Mine

This skill extracts real customer pain from reviews and testimonials - unfiltered, authentic, and actionable. Reviews are where customers complain about problems they'll pay to solve.

Key Distinction from software-ux-research:

  • software-ux-research = UI/UX pain points only
  • startup-review-mining (this skill) = ALL pain dimensions (pricing, support, integration, performance, onboarding, value gaps)

When to Use This Skill

Invoke when users ask for:

  • Pain point extraction from reviews (any source)
  • Competitive weakness analysis
  • Feature gap identification
  • Switching trigger analysis (why customers leave competitors)
  • Market opportunity discovery through customer complaints
  • Review sentiment analysis across platforms
  • B2B software evaluation (G2, Capterra, TrustRadius)
  • B2C app analysis (App Store, Play Store)
  • Community sentiment (Reddit, HN, Twitter/X)
  • Support pain patterns (forums, tickets, Stack Overflow)

Quick Reference Table

Mining TaskSource CategoryTemplateOutput
Full Review MiningAll sourcesreview-mining-report.mdComprehensive pain analysis
B2B SoftwareG2, Capterra, TrustRadiusb2b-review-extraction.mdEnterprise pain points
B2C AppsApp Store, Play Storeb2c-review-extraction.mdConsumer pain points
Tech CommunitiesReddit, HN, ProductHuntcommunity-sentiment.mdTechnical sentiment
Competitor WeaknessCross-platformcompetitor-weakness-matrix.mdCompetitive gaps
Switching TriggersAll sourcesswitching-trigger-analysis.mdWhy customers leave
Feature RequestsAll sourcesfeature-request-aggregator.mdUnmet needs
Opportunity MappingAll sourcesopportunity-from-reviews.mdActionable opportunities

The 7 Pain Dimensions

Reviews reveal pain across 7 dimensions - not just UI/UX:

DimensionWhat to Look ForExample Signals
1. UI/UX PainUsability, navigation, design"confusing interface", "hard to find", "ugly design"
2. Pricing PainCost, billing, contracts"too expensive", "hidden fees", "locked in contract"
3. Support PainResponse time, resolution quality"slow support", "unhelpful", "no documentation"
4. Integration PainAPI complexity, data migration"can't connect to X", "migration nightmare", "no API"
5. Performance PainSpeed, reliability, uptime"slow", "crashes", "downtime", "buggy"
6. Onboarding PainSetup complexity, time-to-value"took weeks to set up", "steep learning curve"
7. Value PainFeature gaps, unmet jobs"missing X feature", "can't do Y", "not what I needed"

Decision Tree: Choosing Mining Approach

Review Mining Need: [What do you want to learn?]
    |
    +-- Finding pain points in a market?
    |   +-- B2B software? → G2 + Capterra + TrustRadius (resources/source-by-source-extraction.md#b2b)
    |   +-- Consumer app? → App Store + Play Store (resources/source-by-source-extraction.md#b2c)
    |   +-- Developer tool? → GitHub Issues + Stack Overflow + HN (resources/source-by-source-extraction.md#tech)
    |
    +-- Analyzing specific competitors?
    |   +-- Direct comparison? → Competitor Weakness Matrix (templates/competitor-weakness-matrix.md)
    |   +-- Why customers switch? → Switching Trigger Analysis (templates/switching-trigger-analysis.md)
    |   +-- Feature gaps? → Feature Request Aggregator (templates/feature-request-aggregator.md)
    |
    +-- Finding opportunities?
    |   +-- Quick wins (<2 weeks)? → Opportunity Template (templates/opportunity-from-reviews.md#quick-wins)
    |   +-- Medium bets (2-8 weeks)? → Opportunity Template (templates/opportunity-from-reviews.md#medium)
    |   +-- Big differentiation? → Opportunity Template (templates/opportunity-from-reviews.md#big-bets)
    |
    +-- Understanding sentiment?
    |   +-- Real-time complaints? → Twitter/X monitoring (resources/source-by-source-extraction.md#social)
    |   +-- Community opinion? → Reddit + HN (resources/source-by-source-extraction.md#community)
    |   +-- Launch feedback? → ProductHunt (resources/source-by-source-extraction.md#producthunt)
    |
    +-- Comprehensive analysis?
        +-- Full market research? → Review Mining Report (templates/review-mining-report.md)

Review Sources (Complete Guide)

Tier 1: Very High Signal (Start Here)

SourceTypeBest ForHow to Access
G2B2B ReviewsEnterprise software paing2.com/products/[name]/reviews
TrustRadiusB2B ReviewsIn-depth technical reviewstrustradius.com/products/[name]/reviews
App StoreB2C ReviewsiOS app painapps.apple.com + AppFollow/Appbot
Play StoreB2C ReviewsAndroid app painplay.google.com + AppFollow/Appbot
GitHub IssuesDeveloperBug patterns, feature requestsgithub.com/[org]/[repo]/issues
Hacker NewsTech CommunityTechnical critiques, scalabilitynews.ycombinator.com + Algolia search
RedditCommunityRaw unfiltered opinionsreddit.com/r/[subreddit]

Tier 2: High Signal

SourceTypeBest ForHow to Access
CapterraB2B ReviewsSMB software comparisonscapterra.com/p/[id]/[name]/reviews
ProductHuntLaunch FeedbackFirst impressions, early adoptersproducthunt.com/products/[name]
Stack OverflowDeveloperIntegration difficultiesstackoverflow.com/questions/tagged/[tag]
Gartner Peer InsightsEnterpriseEnterprise pain, vendor comparisonsgartner.com/reviews/market/[market]
Twitter/XSocialReal-time complaintstwitter.com/search?q=[product]

Tier 3: Medium Signal

SourceTypeBest ForHow to Access
Software AdviceB2BSMB-focused reviewssoftwareadvice.com/[category]
LinkedInProfessionalB2B complaints, professional sentimentlinkedin.com/feed
QuoraQ&AQuestions = unmet needsquora.com/topic/[topic]
YouTube CommentsTutorialConfusion points, documentation gapsyoutube.com/watch?v=[id]
Public Support ForumsSupportRecurring issues, workarounds[product].community.com

Navigation: Resources

Extraction Methodology

Analysis Frameworks

Competitive Intelligence

Opportunity Mapping

External References


Navigation: Templates

Full Reports

Source-Specific Extraction

Competitive Analysis

Pain Analysis

Opportunity Output


Related Skills


Operational Workflow

Standard Mining Flow

1. SCOPE (Define Target)
   +-- Which product/market to analyze?
   +-- Which competitors to include?
   +-- Time range (last 6-12 months recommended)

2. EXTRACT (Gather Data)
   +-- B2B: G2 → Capterra → TrustRadius
   +-- B2C: App Store → Play Store
   +-- Tech: GitHub → HN → Stack Overflow
   +-- Social: Twitter/X → Reddit → LinkedIn

3. CATEGORIZE (7 Dimensions)
   +-- UI/UX Pain
   +-- Pricing Pain
   +-- Support Pain
   +-- Integration Pain
   +-- Performance Pain
   +-- Onboarding Pain
   +-- Value Pain

4. SCORE (Prioritize)
   +-- Frequency (how often mentioned)
   +-- Severity (how painful)
   +-- Addressability (can we solve it?)

5. MAP (Convert to Opportunities)
   +-- Quick Wins (<2 weeks)
   +-- Medium Bets (2-8 weeks)
   +-- Big Differentiation (8+ weeks)

6. OUTPUT (Deliverable)
   +-- Review Mining Report
   +-- Competitor Weakness Matrix
   +-- Opportunity Backlog

Integration with Validation Pipeline

USER ASKS                              SKILL FLOW
──────────────────────────────────────────────────────────────
"Find opportunities in X market"  → startup-review-mining → Pain Report
                                         ↓
"What's trending?"               → startup-trend-prediction → Timing Analysis
                                         ↓
"Should we build this?"          → startup-idea-validation → GO/NO-GO Score
                                         ↓
"What skills do we need?"        → startup-mega-router → Implementation Path

Usage Notes

For Claude: When user asks to "find pain points" or "analyze reviews":

  1. Ask which market/product/competitors to analyze
  2. Use source-by-source-extraction.md for platform-specific queries
  3. Categorize findings into 7 pain dimensions
  4. Score by frequency × severity × addressability
  5. Output using review-mining-report.md template

For Claude: When user asks to "find opportunities":

  1. First extract pain points (above workflow)
  2. Use review-to-opportunity-mapping.md to convert
  3. Categorize into Quick Wins / Medium Bets / Big Differentiation
  4. Feed to startup-idea-validation for scoring

Output Formats:

  • Pain points: 7-dimension matrix with severity scores
  • Competitor analysis: Weakness comparison with quote evidence
  • Opportunities: Prioritized backlog with effort/impact estimates
  • Switching triggers: Why customers leave (ranked by frequency)

Key Principle: Reviews are the voice of the customer. Mine them systematically.

Repository

vasilyu1983
vasilyu1983
Author
vasilyu1983/AI-Agents-public/frameworks/claude-code-kit/framework/skills/startup-review-mining
21
Stars
6
Forks
Updated3d ago
Added6d ago