Voc research

Skill aiskillstore/marketplace/skills/cleanexpo/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.From its SKILL.md

Install

npx -y skills add aiskillstore/marketplace --skill voc-research

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

2.9 KB, 632 tokens by cl100k_base, as published. Nobody here has run it

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

What ships with it: 1 file

13.7 KB alongside SKILL.md

skill-report.json13.7 KB