Marketplace voc-research

Extract Voice of Customer quotes from forums, reviews, and social media. Use when gathering customer language for copywriting, understanding pain points, or building messaging frameworks.

install

source · Clone the upstream repo

git clone https://github.com/aiskillstore/marketplace

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/cleanexpo/voc-research" ~/.claude/skills/aiskillstore-marketplace-voc-research && rm -rf "$T"

manifest: skills/cleanexpo/voc-research/SKILL.md

VOC Research Skill

Purpose

Extract EXACT customer quotes from real sources to inform conversion copywriting with authentic customer language.

Core Principle

Verbatim quotes only - Never summarize. Never paraphrase. Capture the exact words customers use.

Data Sources

Reddit (industry subreddits)
ProductHunt (for SaaS)
Google Reviews
TrustPilot
Facebook Groups
Industry Forums
Support Tickets (internal)

Quote Categories (Per Methodology)

1. Pain Points

What frustrates them, what's broken, what keeps them up at night. Look for: complaints, rants, "I hate when...", "Why can't...", "This is ridiculous..."

2. Symptoms

Observable problems they describe, what they notice going wrong. Look for: descriptions of issues, "I noticed...", "Whenever I...", "The problem is..."

3. Dream Outcomes

What they wish for, ideal scenarios, the transformation they want. Look for: "I wish...", "If only...", "Wouldn't it be great if...", "Imagine if..."

4. Failed Solutions

Things they've tried that didn't work, past disappointments. Look for: "I tried X but...", "Nothing works", "I've already done..."

5. Buying Decisions

What made them choose or not choose, decision factors. Look for: "What sold me was...", "I finally decided because...", "The reason I switched..."

Gold Pattern Detection

Quotes that appear 3+ times across sources are GOLD for messaging. These represent common customer language that resonates widely.

Actions

Search forums/reviews for target industry
Extract exact quotes (copy-paste, no editing)
Categorize into 5 categories
Identify patterns (frequency analysis)
Mark gold quotes (3+ occurrences)
Store in
```
voc_research
```
table

When to Use

Before writing any landing page copy
Before creating marketing campaigns
When updating brand messaging
During client onboarding
Before A/B test hypothesis creation

Integration Points

```
src/lib/agents/voc-research-agent.ts
```
- Main agent
```
voc_research
```
table - Storage
ConversionCopywritingEngine - Consumer

Output Format

{
  "quote": "Exact customer words here",
  "source": "reddit/r/smallbusiness",
  "category": "pain_point",
  "sentiment": -45,
  "keywords": ["invoice", "late", "chasing"],
  "is_gold": true
}

Quality Rules

No AI-generated quotes - Must be real customer language
Preserve typos and slang - Authenticity matters
Include context - Where was this said? Why?
Date quotes - Customer language evolves
Verify sources - Cross-reference when possible