Voice of Customer Synthesizer

Turn scattered customer feedback into a single source of truth. Aggregates signals from every source you have, clusters them into themes, and produces a report that product, marketing, and CS teams can actually act on.

Built for: Startups where customer feedback lives in 6 different places and nobody has time to synthesize it. The founder says "what are customers saying?" and nobody has a clear answer. This skill produces that answer.

When to Use

"What are our customers saying?"
"Synthesize customer feedback from last quarter"
"Build a VoC report for the product team"
"What themes are coming up in customer feedback?"
"Aggregate feedback from all our channels"

Phase 0: Intake

Feedback Sources (provide all you have)

Support tickets — Export from support tool (CSV: customer, date, subject, description, tags, resolution)
NPS/CSAT survey responses — Scores + verbatim comments
Slack messages — Customer channel messages, feedback channels
G2/Capterra reviews — Will scrape if product is listed (provide product name or URL)
Call/meeting transcripts — Customer call recordings or notes
Churn exit survey responses — Why did customers leave?
Feature request log — Internal tracker of what customers have asked for
Social mentions — Twitter/LinkedIn/Reddit threads mentioning your product
Email threads — Notable customer emails (praise or complaints)
In-app feedback — Any in-product feedback submissions

Configuration

Time period — What window to analyze? (Last 30 days, quarter, 6 months)
Product name — For review scraping and context
Report audience — Who's reading this? (Product team, exec team, CS team, all)
Focus areas — Any specific themes to pay attention to? (e.g., "onboarding experience", "pricing feedback", "mobile app")

Phase 1: Data Collection

1A: Internal Data Processing

From the provided inputs, normalize all feedback into a standard format:

SOURCE | DATE | CUSTOMER | SEGMENT | FEEDBACK_TEXT | SENTIMENT | CATEGORY

Sentiment classification per item:

Positive — Praise, satisfaction, delight
Neutral — Feature request, question, observation
Negative — Complaint, frustration, disappointment
Critical — Churn threat, escalation, anger

1B: External Review Scraping (if applicable)

If product is on review platforms:

Chain: review-site-scraper for G2, Capterra, Trustpilot
Filter: reviews from the target time period

Extract: rating, review text, reviewer role/company size, date, pros, cons.

1C: Social Listening (if applicable)

Search: "[product name]" feedback OR review OR "switched to" OR "stopped using"
Search: "[product name]" site:reddit.com OR site:twitter.com

Phase 2: Theme Clustering

Group all feedback items into themes using a bottom-up approach:

Clustering Method

Read all feedback items
Identify recurring topics (mentioned by 3+ customers or in 3+ sources)
Group into theme clusters
Rank by frequency AND severity

Theme Template

THEME: [Name — e.g., "Onboarding Complexity"]
FREQUENCY: [N mentions across M sources]
SENTIMENT: [Predominantly positive/neutral/negative]
TREND: [↑ Growing / → Stable / ↓ Declining vs prior period]

REPRESENTATIVE QUOTES:
- "[Exact quote]" — [Source, Customer segment, Date]
- "[Exact quote]" — [Source, Customer segment, Date]
- "[Exact quote]" — [Source, Customer segment, Date]

CUSTOMER SEGMENTS AFFECTED:
- [Segment 1: e.g., "New customers in first 30 days"]
- [Segment 2: e.g., "Enterprise accounts"]

ROOT CAUSE HYPOTHESIS:
[1-2 sentences: Why is this coming up? What's the underlying issue?]

IMPACT:
- On retention: [High/Medium/Low]
- On expansion: [High/Medium/Low]
- On acquisition: [High/Medium/Low]

Phase 3: Analysis

3A: Sentiment Overview

Overall Sentiment Distribution:
  Positive:  [N] items ([X%])  ████████░░
  Neutral:   [N] items ([X%])  ████░░░░░░
  Negative:  [N] items ([X%])  ██░░░░░░░░
  Critical:  [N] items ([X%])  █░░░░░░░░░

3B: Source Comparison

| Source | Volume | Avg Sentiment | Top Theme | |--------|--------|---------------|-----------| | Support tickets | [N] | [Pos/Neg score] | [Theme] | | NPS comments | [N] | [Score] | [Theme] | | G2 reviews | [N] | [Score] | [Theme] | | Slack | [N] | [Score] | [Theme] | | Calls | [N] | [Score] | [Theme] |

Insight: Different sources often reveal different stories. Support tickets skew negative (problems). Reviews skew bipolar (love/hate). Calls reveal nuance. Note where themes appear across sources for highest confidence.

3C: Segment Analysis

| Customer Segment | Dominant Sentiment | Top Request | Key Pain | |-----------------|-------------------|-------------|----------| | [New customers] | [Sentiment] | [Request] | [Pain] | | [Power users] | [Sentiment] | [Request] | [Pain] | | [Enterprise] | [Sentiment] | [Request] | [Pain] | | [Churned] | [Sentiment] | [Request] | [Pain] |

3D: Trend Detection

Compare against prior period (if available):

| Theme | Prior Period | This Period | Trend | Alert | |-------|-------------|-------------|-------|-------| | [Theme 1] | [N mentions] | [N mentions] | [↑X%] | [New/Growing/Stable/Declining] | | [Theme 2] | ... | ... | ... | ... |

New themes this period: [Themes that weren't present before] Resolved themes: [Themes that decreased significantly — things you fixed]

Phase 4: Recommendations

For Product Team

| Priority | Theme | Recommendation | Evidence Strength | |----------|-------|---------------|-------------------| | P0 | [Theme] | [Specific action] | [N mentions, M sources, includes churn signals] | | P1 | [Theme] | [Action] | [Evidence] | | P2 | [Theme] | [Action] | [Evidence] |

For CS/Support Team

| Action | Theme | Expected Impact | |--------|-------|----------------| | [Create help article for X] | [Theme] | Deflect ~[N] tickets/month | | [Add onboarding step for Y] | [Theme] | Reduce confusion for new users | | [Proactive outreach to segment Z] | [Theme] | Prevent churn in at-risk segment |

For Marketing Team

| Action | Theme | Opportunity | |--------|-------|------------| | [Use this proof point in messaging] | [Positive theme] | "[Customer quote ready for marketing]" | | [Address this objection on website] | [Negative theme] | Counter common concern pre-sale | | [Build case study around X] | [Positive theme] | [N] customers mentioned this win |

Phase 5: Output Format

# Voice of Customer Report — [Period]
Sources analyzed: [list]
Total feedback items: [N]
Date range: [start] — [end]

---

## Executive Summary

[3-5 sentences: What are customers saying? What's the overall sentiment?
What's the single most important thing to act on?]

---

## Sentiment Overview

Positive: [X%] | Neutral: [X%] | Negative: [X%] | Critical: [X%]

Net Sentiment Score: [calculated — % positive minus % negative]
vs Prior Period: [+/- X points]

---

## Top Themes (Ranked by Impact)

### 1. [Theme Name] — [Sentiment] — [N mentions]
**Summary:** [2-3 sentences]
**Key quotes:**
> "[Quote]" — [Source]
> "[Quote]" — [Source]
**Recommended action:** [What to do]
**Owner:** [Product / CS / Marketing]

### 2. [Theme Name] — ...

### 3. [Theme Name] — ...

[Continue for top 5-8 themes]

---

## What Customers Love (Preserve These)

| Strength | Evidence | Marketing Opportunity |
|----------|---------|----------------------|
| [Feature/experience] | "[Quote]" — [N mentions] | [How to use in messaging] |

---

## What Customers Want (Feature Requests)

| Request | Frequency | Segments | Product Priority |
|---------|-----------|----------|-----------------|
| [Feature] | [N mentions] | [Who wants it] | [P0/P1/P2] |

---

## What Causes Pain (Fix These)

| Pain Point | Severity | Churn Risk | Recommended Fix |
|-----------|----------|------------|----------------|
| [Issue] | [High/Med/Low] | [Yes/No] | [Action] |

---

## Trends vs Prior Period

[What's getting better, what's getting worse, what's new]

---

## Team-Specific Action Items

### Product Team
1. [Action] — [Evidence]

### CS Team
1. [Action] — [Evidence]

### Marketing Team
1. [Action] — [Evidence]

---

## Appendix: All Themes Detail

[Full theme cards with all quotes and analysis]

Save to voc-report-[YYYY-MM-DD].md in the current working directory.

Scheduling

Run monthly or quarterly:

0 8 1 */3 * python3 run_skill.py voice-of-customer-synthesizer --client <client-name>

Cost

| Component | Cost | |-----------|------| | Review scraping (via review-site-scraper) | ~$0.50-1.00 | | Web search (social mentions) | Free | | All analysis and synthesis | Free (LLM reasoning) | | Total | Free — $1 |

Tools Required

Optional: review-site-scraper for G2/Capterra/Trustpilot reviews
Optional: twitter-mention-tracker for social mentions
Optional: reddit-post-finder for community feedback
All analysis is pure LLM reasoning on provided data

Trigger Phrases

"What are customers saying?"
"Build a VoC report"
"Synthesize our customer feedback"
"Run voice of customer analysis"
"Customer feedback summary for [period]"

Voice of Customer Synthesizer

When to Use

"What are our customers saying?"
"Synthesize customer feedback from last quarter"
"Build a VoC report for the product team"
"What themes are coming up in customer feedback?"
"Aggregate feedback from all our channels"

Phase 0: Intake

Feedback Sources (provide all you have)

Support tickets — Export from support tool (CSV: customer, date, subject, description, tags, resolution)
NPS/CSAT survey responses — Scores + verbatim comments
Slack messages — Customer channel messages, feedback channels
G2/Capterra reviews — Will scrape if product is listed (provide product name or URL)
Call/meeting transcripts — Customer call recordings or notes
Churn exit survey responses — Why did customers leave?
Feature request log — Internal tracker of what customers have asked for
Social mentions — Twitter/LinkedIn/Reddit threads mentioning your product
Email threads — Notable customer emails (praise or complaints)
In-app feedback — Any in-product feedback submissions

Configuration

Time period — What window to analyze? (Last 30 days, quarter, 6 months)
Product name — For review scraping and context
Report audience — Who's reading this? (Product team, exec team, CS team, all)
Focus areas — Any specific themes to pay attention to? (e.g., "onboarding experience", "pricing feedback", "mobile app")

Phase 1: Data Collection

1A: Internal Data Processing

From the provided inputs, normalize all feedback into a standard format:

SOURCE | DATE | CUSTOMER | SEGMENT | FEEDBACK_TEXT | SENTIMENT | CATEGORY

Sentiment classification per item:

Positive — Praise, satisfaction, delight
Neutral — Feature request, question, observation
Negative — Complaint, frustration, disappointment
Critical — Churn threat, escalation, anger

1B: External Review Scraping (if applicable)

If product is on review platforms:

Chain: review-site-scraper for G2, Capterra, Trustpilot
Filter: reviews from the target time period

Extract: rating, review text, reviewer role/company size, date, pros, cons.

1C: Social Listening (if applicable)

Search: "[product name]" feedback OR review OR "switched to" OR "stopped using"
Search: "[product name]" site:reddit.com OR site:twitter.com

Phase 2: Theme Clustering

Group all feedback items into themes using a bottom-up approach:

Clustering Method

Read all feedback items
Identify recurring topics (mentioned by 3+ customers or in 3+ sources)
Group into theme clusters
Rank by frequency AND severity

Theme Template

THEME: [Name — e.g., "Onboarding Complexity"]
FREQUENCY: [N mentions across M sources]
SENTIMENT: [Predominantly positive/neutral/negative]
TREND: [↑ Growing / → Stable / ↓ Declining vs prior period]

REPRESENTATIVE QUOTES:
- "[Exact quote]" — [Source, Customer segment, Date]
- "[Exact quote]" — [Source, Customer segment, Date]
- "[Exact quote]" — [Source, Customer segment, Date]

CUSTOMER SEGMENTS AFFECTED:
- [Segment 1: e.g., "New customers in first 30 days"]
- [Segment 2: e.g., "Enterprise accounts"]

ROOT CAUSE HYPOTHESIS:
[1-2 sentences: Why is this coming up? What's the underlying issue?]

IMPACT:
- On retention: [High/Medium/Low]
- On expansion: [High/Medium/Low]
- On acquisition: [High/Medium/Low]

Phase 3: Analysis

3A: Sentiment Overview

Overall Sentiment Distribution:
  Positive:  [N] items ([X%])  ████████░░
  Neutral:   [N] items ([X%])  ████░░░░░░
  Negative:  [N] items ([X%])  ██░░░░░░░░
  Critical:  [N] items ([X%])  █░░░░░░░░░

3B: Source Comparison

3C: Segment Analysis

3D: Trend Detection

Compare against prior period (if available):

New themes this period: [Themes that weren't present before] Resolved themes: [Themes that decreased significantly — things you fixed]

Phase 4: Recommendations

For Product Team

For CS/Support Team

For Marketing Team

Phase 5: Output Format

# Voice of Customer Report — [Period]
Sources analyzed: [list]
Total feedback items: [N]
Date range: [start] — [end]

---

## Executive Summary

[3-5 sentences: What are customers saying? What's the overall sentiment?
What's the single most important thing to act on?]

---

## Sentiment Overview

Positive: [X%] | Neutral: [X%] | Negative: [X%] | Critical: [X%]

Net Sentiment Score: [calculated — % positive minus % negative]
vs Prior Period: [+/- X points]

---

## Top Themes (Ranked by Impact)

### 1. [Theme Name] — [Sentiment] — [N mentions]
**Summary:** [2-3 sentences]
**Key quotes:**
> "[Quote]" — [Source]
> "[Quote]" — [Source]
**Recommended action:** [What to do]
**Owner:** [Product / CS / Marketing]

### 2. [Theme Name] — ...

### 3. [Theme Name] — ...

[Continue for top 5-8 themes]

---

## What Customers Love (Preserve These)

| Strength | Evidence | Marketing Opportunity |
|----------|---------|----------------------|
| [Feature/experience] | "[Quote]" — [N mentions] | [How to use in messaging] |

---

## What Customers Want (Feature Requests)

| Request | Frequency | Segments | Product Priority |
|---------|-----------|----------|-----------------|
| [Feature] | [N mentions] | [Who wants it] | [P0/P1/P2] |

---

## What Causes Pain (Fix These)

| Pain Point | Severity | Churn Risk | Recommended Fix |
|-----------|----------|------------|----------------|
| [Issue] | [High/Med/Low] | [Yes/No] | [Action] |

---

## Trends vs Prior Period

[What's getting better, what's getting worse, what's new]

---

## Team-Specific Action Items

### Product Team
1. [Action] — [Evidence]

### CS Team
1. [Action] — [Evidence]

### Marketing Team
1. [Action] — [Evidence]

---

## Appendix: All Themes Detail

[Full theme cards with all quotes and analysis]

Save to voc-report-[YYYY-MM-DD].md in the current working directory.

Scheduling

Run monthly or quarterly:

0 8 1 */3 * python3 run_skill.py voice-of-customer-synthesizer --client <client-name>

Cost

Tools Required

Optional: review-site-scraper for G2/Capterra/Trustpilot reviews
Optional: twitter-mention-tracker for social mentions
Optional: reddit-post-finder for community feedback
All analysis is pure LLM reasoning on provided data

Trigger Phrases

"What are customers saying?"
"Build a VoC report"
"Synthesize our customer feedback"
"Run voice of customer analysis"
"Customer feedback summary for [period]"

Adoption

athina-ai/voice-of-customer-synthesizer

$ install --global

Security Scan Results

SKILL.md

Voice of Customer Synthesizer

When to Use

Phase 0: Intake

Feedback Sources (provide all you have)

Configuration

Phase 1: Data Collection

1A: Internal Data Processing

1B: External Review Scraping (if applicable)

1C: Social Listening (if applicable)

Phase 2: Theme Clustering

Clustering Method

Theme Template

Phase 3: Analysis

3A: Sentiment Overview

3B: Source Comparison

3C: Segment Analysis

3D: Trend Detection

Phase 4: Recommendations

For Product Team

For CS/Support Team

For Marketing Team

Phase 5: Output Format

Scheduling

Cost

Tools Required

Trigger Phrases

Related Skills

athina-ai/video-polish

athina-ai/video-clipper

athina-ai/talking-head-video

athina-ai/product-reel-generator

athina-ai/voice-of-customer-synthesizer

$ install --global

Security Scan Results

SKILL.md

Voice of Customer Synthesizer

When to Use

Phase 0: Intake

Feedback Sources (provide all you have)

Configuration

Phase 1: Data Collection

1A: Internal Data Processing

1B: External Review Scraping (if applicable)

1C: Social Listening (if applicable)

Phase 2: Theme Clustering

Clustering Method

Theme Template

Phase 3: Analysis

3A: Sentiment Overview

3B: Source Comparison

3C: Segment Analysis

3D: Trend Detection

Phase 4: Recommendations

For Product Team

For CS/Support Team

For Marketing Team

Phase 5: Output Format

Scheduling

Cost

Tools Required

Trigger Phrases

Related Skills

athina-ai/video-polish

athina-ai/video-clipper

athina-ai/talking-head-video

athina-ai/product-reel-generator