App Review Analyzer

---
name: app-review-analyzer
description:
  Systematically analyze app reviews for competitor research or own-app
  reputation management. Categorize reviews by sentiment and themes (bugs,
  missing features, UX complaints, pricing objections, praise, support issues),
  identify actionable patterns, produce structured analysis reports, and draft
  professional review responses. Use when the user says "analyze app reviews",
  "review analysis", "competitor reviews", "respond to reviews", "app review
  report", "what are users complaining about", "review sentiment analysis",
  "draft review responses", or wants to understand user feedback patterns for
  any iOS App Store or Google Play app.
---

## Prerequisites

- **Chrome browser** with Claude in Chrome extension (for reading store reviews)
- No API keys required — all analysis is done through live browser interaction
- Supports **iOS App Store** and **Google Play Store**

## Mode Selection

Ask the user which mode they need:

1. **Competitive Analysis** — Analyze a competitor's reviews to find gaps and
   opportunities
2. **Own App Management** — Analyze your own app's reviews to prioritize fixes,
   surface feature requests, and draft professional responses

If the user provides a competitor's app, use Competitive Analysis mode. If they
mention "my app" or "our app," use Own App Management mode.

---

## Competitive Analysis Mode

### Step 1: Navigate to the App Listing

Open the app's store page in Chrome:

- **iOS App Store:** Search on apps.apple.com or use a direct link
- **Google Play:** Search on play.google.com or use a direct link

Confirm the correct app with the user before proceeding.

### Step 2: Collect Reviews Systematically

Read reviews in two passes:

1. **Most Recent** — Sort by newest first. Read at least 30-50 reviews to
   capture current sentiment.
2. **Most Critical** — Sort by lowest rating (1-star, then 2-star). Read at
   least 20-30 critical reviews to surface pain points.

For each review, note:

- Star rating
- Date posted
- Review text (key quotes)
- Whether the developer responded

### Step 3: Categorize Reviews

Assign each review to one or more theme categories:

| Category               | Signals                                                          |
| ---------------------- | ---------------------------------------------------------------- |
| **Bug Reports**        | Crashes, errors, data loss, freezing, sync failures              |
| **Missing Features**   | "I wish it had...", "Why can't I...", "Needs..."                 |
| **UX Complaints**      | "Too complicated", "Can't find...", "Confusing", "Slow"          |
| **Pricing Objections** | "Too expensive", "Not worth it", "Used to be free"               |
| **Praise**             | Specific features users love, "best app for...", loyalty signals |
| **Support Complaints** | "No response", "Unhelpful", "Can't reach anyone"                 |

### Step 4: Produce the Analysis Report

Generate a structured report using the template in
`references/analysis-report-template.md`. The report must include:

1. **Theme Frequency Table** — Count of reviews per category, sorted by
   frequency
2. **Sentiment Trend** — Are recent reviews better or worse than older ones?
3. **Top 5 Pain Points** — With direct quotes from reviews
4. **Top 5 Praised Features** — Competitor strengths you must match or exceed
5. **Opportunity Summary** — Gaps you could fill, weaknesses to exploit

---

## Own App Management Mode

### Step 1: Navigate to Your App's Reviews

Open your app's store page in Chrome. Confirm the correct app.

### Step 2: Collect and Categorize Reviews

Follow the same collection process as Competitive Analysis (Steps 2-3 above).

### Step 3: Prioritize Issues

Score each theme by **Frequency x Severity**:

| Severity         | Definition                                               |
| ---------------- | -------------------------------------------------------- |
| **Critical (3)** | Data loss, crashes, security issues, payment failures    |
| **High (2)**     | Core functionality broken, major UX blockers             |
| **Medium (1)**   | Nice-to-have features, minor annoyances, cosmetic issues |

Calculate priority score: `count of reviews in theme x severity weight`

Sort themes by priority score descending. This is the fix-first order.

### Step 4: Draft Review Responses

For each negative review (1-3 stars), draft a response following the templates
in `references/response-templates.md`.

Key response principles:

- Respond within 24-48 hours — speed improves update likelihood
- Never be defensive or argumentative
- Personalize every response — reference specific details from their review
- Acknowledge the problem before offering solutions
- Include a direct contact method for follow-up when appropriate
- Keep responses concise (2-4 sentences for most cases)

Platform-specific notes:

- **iOS App Store:** Developer responses appear publicly under the review. Users
  receive a notification and can update their rating.
- **Google Play:** Developer responses also appear publicly. You can report
  policy-violating reviews (spam, off-topic, profanity) via the Play Console.

### Step 5: Produce the Action Plan

Generate a report using `references/analysis-report-template.md` with an
additional action plan section:

1. **Fix First** — Critical bugs and top pain points by priority score
2. **Add Next** — Most-requested features with user quotes as evidence
3. **Communicate** — Issues that need a public response or in-app messaging
4. **Monitor** — Themes to watch in future review cycles

---

## Review Category Quick Reference

Use this decision tree when categorizing ambiguous reviews:

```
Review mentions a crash/error/data loss?
  → Bug Report

Review says "I wish" or "please add" or "why can't I"?
  → Missing Feature

Review says "confusing" or "hard to use" or "can't find"?
  → UX Complaint

Review mentions price, subscription, cost, or payment?
  → Pricing Objection

Review says "no response" or "support" or "help"?
  → Support Complaint

Review is purely positive with no complaints?
  → Praise

Review has multiple themes?
  → Assign all applicable categories
```

## Resources

### references/

- **response-templates.md** — Detailed response templates for every review
  category with multiple variants each. Load when drafting review responses.
- **analysis-report-template.md** — Full markdown template for the analysis
  report output. Load when producing the final report.