UGC Moderation Assistant
Overview
This skill provides a structured moderation framework for user-generated content (UGC) across e-commerce platforms — product reviews, ratings, Q&A, community forums, and user-submitted photos/videos. It balances brand protection with authentic consumer voice, applying regulatory, legal, and brand-safety filters while preserving genuine feedback that drives conversion.
Authentic reviews increase conversion rates by 15-30%. The goal is not to suppress negative feedback but to ensure all published content is genuine, compliant, and safe.
When to Use
- Processing incoming product reviews before publication on DTC or marketplace storefronts.
- Moderating Q&A submissions on product detail pages.
- Screening user-submitted photos and videos for brand safety.
- Auditing existing review corpuses for policy violations or fake review patterns.
- Generating moderation reports for brand and legal teams.
- Responding to or flagging reviews that require brand intervention.
Required Inputs
| Input |
Description |
Example |
ugc_content |
The user-generated text, rating, and metadata |
{ "text": "...", "rating": 4, "author": "...", "date": "..." } |
product_info |
Associated product name, category, and claims |
Product record |
moderation_policy |
Brand-specific moderation rules and thresholds |
Policy document |
channel |
Platform where UGC will appear |
"DTC Shopify", "Amazon Vine", "Bazaarvoice" |
media_attachments |
URLs to any user-uploaded images or videos |
List of URLs |
escalation_contacts |
Contacts for legal, PR, and customer service escalation |
Email/Slack channels |
historical_patterns |
Known fake review patterns or repeat offenders |
Pattern library |
Methodology
Step 1 — Content Classification
Classify each piece of UGC into a moderation category:
| Category |
Definition |
Default Action |
| Approved |
Genuine, policy-compliant, and relevant |
Publish |
| Approved with Edit |
Minor issues (PII, formatting) that can be auto-corrected |
Publish after edit |
| Flagged for Review |
Ambiguous content requiring human judgment |
Queue for manual review |
| Rejected — Policy |
Violates moderation policy (profanity, hate speech, threats) |
Block with reason code |
| Rejected — Compliance |
Contains regulated claims or legal risk |
Block and escalate |
| Rejected — Authenticity |
Suspected fake, incentivized, or competitor-planted review |
Block and log |
Step 2 — Authenticity Assessment
Apply the Review Authenticity Scorecard to detect inauthentic content:
| Signal |
Weight |
Indicators |
| Linguistic Analysis |
25% |
Generic language, excessive superlatives, template patterns, lack of product-specific detail |
| Behavioral Patterns |
25% |
Review velocity (multiple reviews in minutes), reviewer history, geographic anomalies |
| Purchase Verification |
20% |
Verified purchase flag, order-to-review timing (< 24hrs suspicious, > 90 days stale) |
| Sentiment-Rating Alignment |
15% |
5-star rating with negative text, or vice versa — indicates manipulation |
| Duplicate Detection |
15% |
Near-duplicate text across products, accounts, or time periods |
Authenticity Score: 0-100. Content below 40 is auto-rejected. 40-65 is flagged for human review. Above 65 passes authenticity gate.
Step 3 — Safety & Compliance Screening
Screen content against multiple safety layers:
Legal Safety:
- PII detection: email addresses, phone numbers, full names of non-public individuals, addresses.
- Defamation risk: false statements of fact about competitors or individuals.
- Intellectual property: copyrighted text, trademarked terms used inappropriately.
Regulatory Compliance:
- Health/medical claims in reviews: "This cured my diabetes" — flag for disclaimer or removal.
- Off-label use descriptions for regulated products.
- Adverse event reports (FDA-reportable for supplements, OTC drugs, cosmetics).
Brand Safety:
- Profanity and hate speech (zero tolerance).
- Violent or sexually explicit content.
- Competitor promotion or spam links.
- Politically divisive or discriminatory language.
Step 4 — Adverse Event Detection (CPG-Specific)
For FDA-regulated categories (supplements, OTC, cosmetics, food), identify potential adverse event reports:
- Scan for medical terminology: "allergic reaction," "rash," "hospitalized," "side effect."
- Classify severity: mild (discomfort), moderate (required medical attention), serious (hospitalization, life-threatening).
- Serious adverse events trigger mandatory escalation to regulatory affairs within 24 hours.
- Log all adverse event mentions in the pharmacovigilance tracking system.
Step 5 — Sentiment Analysis & Brand Intelligence
Extract actionable intelligence from approved UGC:
- Sentiment Distribution: Positive / neutral / negative ratio by product and time period.
- Topic Clustering: Group reviews by theme (packaging, taste, efficacy, value, shipping).
- Emerging Issues: Detect sudden spikes in negative sentiment on specific topics.
- Competitive Mentions: Track competitor name mentions and comparative sentiment.
- Feature Requests: Identify recurring requests for product improvements.
Step 6 — Response Prioritization
Rank reviews requiring brand response by urgency:
| Priority |
Criteria |
Response SLA |
| P0 — Crisis |
Safety issue, viral potential, adverse event |
2 hours |
| P1 — Urgent |
1-star verified purchase with specific product defect |
24 hours |
| P2 — Important |
Detailed negative review with actionable feedback |
48 hours |
| P3 — Standard |
Positive review warranting thank-you response |
72 hours |
| P4 — Monitor |
Neutral review, no action needed |
No response required |
Output Specification
output:
moderation_decision: string # "approved" | "approved_with_edit" | "flagged" | "rejected"
rejection_reason: string # Policy code if rejected
authenticity_score: float # 0-100
safety_flags: list[string] # Specific safety issues found
adverse_event_detected: boolean
adverse_event_severity: string # "mild" | "moderate" | "serious" | null
sentiment: string # "positive" | "neutral" | "negative"
topics: list[string] # Extracted themes
response_priority: string # P0-P4
suggested_response: string # Draft brand response if P0-P3
edits_applied: list[string] # Auto-corrections made (PII redaction, etc.)
pii_redacted: boolean
Analysis Framework
UGC Health Dashboard Metrics (aggregate across all moderated content):
| Metric |
Healthy Range |
Alert Threshold |
| Approval Rate |
85-95% |
< 75% (overly restrictive) or > 98% (under-moderated) |
| Fake Review Rate |
< 5% |
> 10% |
| Avg Authenticity Score |
> 75 |
< 60 |
| Adverse Event Rate |
< 0.1% |
> 0.5% (potential product issue) |
| Avg Response Time (P0/P1) |
< 12 hrs |
> 24 hrs |
| Sentiment Trend |
Stable or improving |
3+ consecutive weeks declining |
Examples
Input Review: "TERRIBLE product!! Gave me a horrible rash all over my arms. Called my doctor and he said it was a chemical burn. DO NOT BUY. Contact me at jane.smith@email.com to join the lawsuit."
Analysis:
- Moderation Decision: Rejected — Compliance
- Authenticity Score: 78 (genuine language, specific details)
- Safety Flags: PII detected (email), potential legal threat
- Adverse Event: Detected — Severity: Moderate (required medical attention)
- Response Priority: P0 — Crisis
- Actions: (1) Redact email address. (2) Escalate adverse event to regulatory affairs immediately. (3) Escalate legal threat to legal team. (4) Draft empathetic response with customer service contact.
Guidelines
- Never suppress genuine negative reviews — they build trust and provide product intelligence.
- Adverse event detection is a legal obligation for FDA-regulated products. Err on the side of over-reporting.
- PII must be redacted before publication, never after.
- Incentivized reviews (samples, discounts) must be disclosed per FTC guidelines.
- Maintain consistent moderation standards regardless of rating — do not apply stricter standards to negative reviews.
- All moderation decisions must be logged with timestamps and rationale for audit trails.
Validation Checklist
1---2name: ugc-moderation-assistant3description: Screen, classify, and moderate user-generated content including product reviews, Q&A submissions, community posts, and uploaded media for CPG and retail e-commerce platforms.4---56# UGC Moderation Assistant78## Overview910This skill provides a structured moderation framework for user-generated content (UGC) across e-commerce platforms — product reviews, ratings, Q&A, community forums, and user-submitted photos/videos. It balances brand protection with authentic consumer voice, applying regulatory, legal, and brand-safety filters while preserving genuine feedback that drives conversion.1112Authentic reviews increase conversion rates by 15-30%. The goal is not to suppress negative feedback but to ensure all published content is genuine, compliant, and safe.1314## When to Use1516- Processing incoming product reviews before publication on DTC or marketplace storefronts.17- Moderating Q&A submissions on product detail pages.18- Screening user-submitted photos and videos for brand safety.19- Auditing existing review corpuses for policy violations or fake review patterns.20- Generating moderation reports for brand and legal teams.21- Responding to or flagging reviews that require brand intervention.2223## Required Inputs2425| Input | Description | Example |26|---|---|---|27| `ugc_content` | The user-generated text, rating, and metadata | `{ "text": "...", "rating": 4, "author": "...", "date": "..." }` |28| `product_info` | Associated product name, category, and claims | Product record |29| `moderation_policy` | Brand-specific moderation rules and thresholds | Policy document |30| `channel` | Platform where UGC will appear | "DTC Shopify", "Amazon Vine", "Bazaarvoice" |31| `media_attachments` | URLs to any user-uploaded images or videos | List of URLs |32| `escalation_contacts` | Contacts for legal, PR, and customer service escalation | Email/Slack channels |33| `historical_patterns` | Known fake review patterns or repeat offenders | Pattern library |3435## Methodology3637### Step 1 — Content Classification3839Classify each piece of UGC into a moderation category:4041| Category | Definition | Default Action |42|---|---|---|43| **Approved** | Genuine, policy-compliant, and relevant | Publish |44| **Approved with Edit** | Minor issues (PII, formatting) that can be auto-corrected | Publish after edit |45| **Flagged for Review** | Ambiguous content requiring human judgment | Queue for manual review |46| **Rejected — Policy** | Violates moderation policy (profanity, hate speech, threats) | Block with reason code |47| **Rejected — Compliance** | Contains regulated claims or legal risk | Block and escalate |48| **Rejected — Authenticity** | Suspected fake, incentivized, or competitor-planted review | Block and log |4950### Step 2 — Authenticity Assessment5152Apply the **Review Authenticity Scorecard** to detect inauthentic content:5354| Signal | Weight | Indicators |55|---|---|---|56| Linguistic Analysis | 25% | Generic language, excessive superlatives, template patterns, lack of product-specific detail |57| Behavioral Patterns | 25% | Review velocity (multiple reviews in minutes), reviewer history, geographic anomalies |58| Purchase Verification | 20% | Verified purchase flag, order-to-review timing (< 24hrs suspicious, > 90 days stale) |59| Sentiment-Rating Alignment | 15% | 5-star rating with negative text, or vice versa — indicates manipulation |60| Duplicate Detection | 15% | Near-duplicate text across products, accounts, or time periods |6162**Authenticity Score**: 0-100. Content below 40 is auto-rejected. 40-65 is flagged for human review. Above 65 passes authenticity gate.6364### Step 3 — Safety & Compliance Screening6566Screen content against multiple safety layers:6768**Legal Safety**:69- PII detection: email addresses, phone numbers, full names of non-public individuals, addresses.70- Defamation risk: false statements of fact about competitors or individuals.71- Intellectual property: copyrighted text, trademarked terms used inappropriately.7273**Regulatory Compliance**:74- Health/medical claims in reviews: "This cured my diabetes" — flag for disclaimer or removal.75- Off-label use descriptions for regulated products.76- Adverse event reports (FDA-reportable for supplements, OTC drugs, cosmetics).7778**Brand Safety**:79- Profanity and hate speech (zero tolerance).80- Violent or sexually explicit content.81- Competitor promotion or spam links.82- Politically divisive or discriminatory language.8384### Step 4 — Adverse Event Detection (CPG-Specific)8586For FDA-regulated categories (supplements, OTC, cosmetics, food), identify potential adverse event reports:87881. Scan for medical terminology: "allergic reaction," "rash," "hospitalized," "side effect."892. Classify severity: mild (discomfort), moderate (required medical attention), serious (hospitalization, life-threatening).903. Serious adverse events trigger **mandatory escalation** to regulatory affairs within 24 hours.914. Log all adverse event mentions in the pharmacovigilance tracking system.9293### Step 5 — Sentiment Analysis & Brand Intelligence9495Extract actionable intelligence from approved UGC:9697- **Sentiment Distribution**: Positive / neutral / negative ratio by product and time period.98- **Topic Clustering**: Group reviews by theme (packaging, taste, efficacy, value, shipping).99- **Emerging Issues**: Detect sudden spikes in negative sentiment on specific topics.100- **Competitive Mentions**: Track competitor name mentions and comparative sentiment.101- **Feature Requests**: Identify recurring requests for product improvements.102103### Step 6 — Response Prioritization104105Rank reviews requiring brand response by urgency:106107| Priority | Criteria | Response SLA |108|---|---|---|109| **P0 — Crisis** | Safety issue, viral potential, adverse event | 2 hours |110| **P1 — Urgent** | 1-star verified purchase with specific product defect | 24 hours |111| **P2 — Important** | Detailed negative review with actionable feedback | 48 hours |112| **P3 — Standard** | Positive review warranting thank-you response | 72 hours |113| **P4 — Monitor** | Neutral review, no action needed | No response required |114115## Output Specification116117```yaml118output:119 moderation_decision: string # "approved" | "approved_with_edit" | "flagged" | "rejected"120 rejection_reason: string # Policy code if rejected121 authenticity_score: float # 0-100122 safety_flags: list[string] # Specific safety issues found123 adverse_event_detected: boolean124 adverse_event_severity: string # "mild" | "moderate" | "serious" | null125 sentiment: string # "positive" | "neutral" | "negative"126 topics: list[string] # Extracted themes127 response_priority: string # P0-P4128 suggested_response: string # Draft brand response if P0-P3129 edits_applied: list[string] # Auto-corrections made (PII redaction, etc.)130 pii_redacted: boolean131```132133## Analysis Framework134135**UGC Health Dashboard Metrics** (aggregate across all moderated content):136137| Metric | Healthy Range | Alert Threshold |138|---|---|---|139| Approval Rate | 85-95% | < 75% (overly restrictive) or > 98% (under-moderated) |140| Fake Review Rate | < 5% | > 10% |141| Avg Authenticity Score | > 75 | < 60 |142| Adverse Event Rate | < 0.1% | > 0.5% (potential product issue) |143| Avg Response Time (P0/P1) | < 12 hrs | > 24 hrs |144| Sentiment Trend | Stable or improving | 3+ consecutive weeks declining |145146## Examples147148**Input Review**: "TERRIBLE product!! Gave me a horrible rash all over my arms. Called my doctor and he said it was a chemical burn. DO NOT BUY. Contact me at jane.smith@email.com to join the lawsuit."149150**Analysis**:151- **Moderation Decision**: Rejected — Compliance152- **Authenticity Score**: 78 (genuine language, specific details)153- **Safety Flags**: PII detected (email), potential legal threat154- **Adverse Event**: Detected — Severity: Moderate (required medical attention)155- **Response Priority**: P0 — Crisis156- **Actions**: (1) Redact email address. (2) Escalate adverse event to regulatory affairs immediately. (3) Escalate legal threat to legal team. (4) Draft empathetic response with customer service contact.157158## Guidelines159160- Never suppress genuine negative reviews — they build trust and provide product intelligence.161- Adverse event detection is a legal obligation for FDA-regulated products. Err on the side of over-reporting.162- PII must be redacted before publication, never after.163- Incentivized reviews (samples, discounts) must be disclosed per FTC guidelines.164- Maintain consistent moderation standards regardless of rating — do not apply stricter standards to negative reviews.165- All moderation decisions must be logged with timestamps and rationale for audit trails.166167## Validation Checklist168169- [ ] Content is classified into the correct moderation category.170- [ ] Authenticity score is calculated using all five signal dimensions.171- [ ] PII is detected and redacted before any publication decision.172- [ ] Adverse events are identified, classified by severity, and escalated per protocol.173- [ ] Safety screening covers legal, regulatory, and brand-safety layers.174- [ ] Response priority is assigned based on urgency criteria.175- [ ] Suggested brand response is drafted for P0-P3 reviews.176- [ ] Moderation decision is logged with full audit trail.177- [ ] Fake review patterns are cross-referenced against historical data.178- [ ] Aggregate moderation metrics fall within healthy ranges.