Back to library

Customer review theme analysis

Clusters customer reviews into evidenced themes, separates praise from complaints, quantifies sentiment and product areas, and surfaces representative quotes with source identifiers. Use for review mining, voice-of-customer reporting, product feedback synthesis, or reputation monitoring.

by adlass TemplatesVersion 1Uses adlass toolsUniversal

Published Aug 21, 2026 · Updated Aug 26, 2026

Helpful · 0View raw SKILL.md

Requirements

Map review fields and product taxonomy to the source table. Set language handling and sentiment labels. Define severity, volume, recency, and ownership rules. Add prior theme register and privacy requirements.

Skill document

The full SKILL.md your agent reads and follows.

Customer review theme analysis

Purpose

Turn free-text customer reviews into a stable set of themes that product, support, and marketing can act on. The analysis preserves the original wording and shows how often each theme occurs.

Scope

Analyze the supplied review corpus for the selected period, channels, products, and languages. Code topic, sentiment, rating context, recurrence, and representative evidence while retaining review-level traceability.

Excluded: identifying reviewers, responding to reviews, proving causation, weighting an unprovided sample, or treating one anecdote as a population estimate.

Data basis

  • Review table columns review_id, date, rating, channel, product, text, language, and verified.
  • Product taxonomy and sentiment or theme coding guide.
  • Prior theme register with theme_id, definition, owner, and trend status.
  • Customer segment and response-policy references.

Result

A theme analysis report, coded review sheet, and prioritized issue register.

Quality criteria

  • Every coded review retains review_id, date, rating, channel, and source text citation.
  • Theme definitions are mutually distinguishable and include inclusion and exclusion examples.
  • Counts reconcile to the review population after language, duplicate, and spam dispositions.
  • Sentiment is reported as coded polarity, not as a psychological claim.
  • Priority combines stated business criteria with volume and severity evidence.

Instructions

Deduplicate only when review text, author marker, and timestamp support the match; keep uncertain duplicates separate. Translate only when a translation source is supplied and preserve the original language. A review can receive multiple themes, but the report must state whether counts are review-level or mention-level. Quote only the minimum representative text and mask personal data. Do not rank a theme without naming its denominator and priority rule.

Adapt before use

  • Map review fields and product taxonomy to the source table.
  • Set language handling and sentiment labels.
  • Define severity, volume, recency, and ownership rules.
  • Add prior theme register and privacy requirements.

Related skills

  • Complaint response and root-cause note

    Delivers a structured complaint response and root-cause note result with evidence, decisions, and open points. Use when teams need complaint response and root-cause note, support operations review, customer success analysis, or a repeatable case-work deliverable.

  • Customer health review

    Delivers a structured customer health review result with evidence, decisions, and open points. Use when teams need customer health review, support operations review, customer success analysis, or a repeatable case-work deliverable.

  • Customer onboarding plan

    Delivers a structured customer onboarding plan result with evidence, decisions, and open points. Use when teams need customer onboarding plan, support operations review, customer success analysis, or a repeatable case-work deliverable.

  • Customer success plan update

    Delivers a structured customer success plan update result with evidence, decisions, and open points. Use when teams need customer success plan update, support operations review, customer success analysis, or a repeatable case-work deliverable.