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.
Best use case
voc-research is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. 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.
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.
Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.
Practical example
Example input
Use the "voc-research" skill to help with this workflow task. Context: 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.
Example output
A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.
When to use this skill
- Use this skill when you want a reusable workflow rather than writing the same prompt again and again.
When not to use this skill
- Do not use this when you only need a one-off answer and do not need a reusable workflow.
- Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/voc-research/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How voc-research Compares
| Feature / Agent | voc-research | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
AI Agent for SaaS Idea Validation
Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
SKILL.md Source
# 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
1. Search forums/reviews for target industry
2. Extract exact quotes (copy-paste, no editing)
3. Categorize into 5 categories
4. Identify patterns (frequency analysis)
5. Mark gold quotes (3+ occurrences)
6. 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
```json
{
"quote": "Exact customer words here",
"source": "reddit/r/smallbusiness",
"category": "pain_point",
"sentiment": -45,
"keywords": ["invoice", "late", "chasing"],
"is_gold": true
}
```
## Quality Rules
1. **No AI-generated quotes** - Must be real customer language
2. **Preserve typos and slang** - Authenticity matters
3. **Include context** - Where was this said? Why?
4. **Date quotes** - Customer language evolves
5. **Verify sources** - Cross-reference when possibleRelated Skills
wiki-researcher
Conducts multi-turn iterative deep research on specific topics within a codebase with zero tolerance for shallow analysis. Use when the user wants an in-depth investigation, needs to understand how something works across multiple files, or asks for comprehensive analysis of a specific system or pattern.
research-engineer
An uncompromising Academic Research Engineer. Operates with absolute scientific rigor, objective criticism, and zero flair. Focuses on theoretical correctness, formal verification, and optimal implementation across any required technology.
context7-auto-research
Automatically fetch latest library/framework documentation for Claude Code via Context7 API
research-merge
Processes research branches from Claude Code Web sessions - merges content, moves docs to docs/research/, and creates GitHub issues. Use when /popkit:next detects research branches or when manually processing research from mobile sessions. Do NOT use for regular feature branches - only for branches matching claude/research-* or containing research documentation.
web-research
Use this skill for requests related to web research; it provides a structured approach to conducting comprehensive web research.
research-driven-planning
Loop 1 of the Three-Loop Integrated Development System. Research-driven requirements analysis with iterative risk mitigation through 5x pre-mortem cycles using multi-agent consensus. Feeds validated, risk-mitigated plans to parallel-swarm-implementation. Use when starting new features or projects requiring comprehensive planning with <3% failure confidence and evidence-based technology selection.
research-lookup
Look up current research information using Perplexity's Sonar Pro Search or Sonar Reasoning Pro models through OpenRouter. Automatically selects the best model based on query complexity. Search academic papers, recent studies, technical documentation, and general research information with citations.
research-grants
Write competitive research proposals for NSF, NIH, DOE, and DARPA. Agency-specific formatting, review criteria, budget preparation, broader impacts, significance statements, innovation narratives, and compliance with submission requirements.
notion-research-documentation
Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.
market-research-reports
Generate comprehensive market research reports (50+ pages) in the style of top consulting firms (McKinsey, BCG, Gartner). Features professional LaTeX formatting, extensive visual generation with scientific-schematics and generate-image, deep integration with research-lookup for data gathering, and multi-framework strategic analysis including Porter's Five Forces, PESTLE, SWOT, TAM/SAM/SOM, and BCG Matrix.
gemini-research-subagent
Delegates large-context code analysis to Gemini CLI. Use when analyzing codebases, tracing bugs across files, reviewing architecture, or performing security audits. Gemini reads, Claude implements.
research
Multi-source parallel research with confidence-based synthesis.