🧰 Customer Review Theme Miner
Groups a batch of pasted customer reviews into recurring praise and complaint themes, counts them, quotes real lines and turns them into product and listing fixes.
What it does
Paste reviews for your product or a competitor’s (or point the skill at a text/CSV export). It sorts them into themes like sizing, packaging or durability, counts how many reviews mention each, quotes the actual wording, and suggests what to change in the product, the listing copy or the supplier spec.
Use it when: you’re deciding what to fix before a reorder, writing listing bullets that answer real objections, or comparing your reviews with a competitor’s.
Works with: Claude Code, Claude.ai (Skills upload), Cursor and Codex. Install the ZIP, then ask your agent to mine themes from the reviews.
Counts come only from the reviews you provide, so a small sample gives rough signals, not market data.
Output preview
Task given to the agent: “Read and follow .agents/skills/review-theme-miner/SKILL.md before you answer. Use that skill's output format. Mine themes from these 10 customer reviews of our 12 oz matte ceramic mug. I'm deciding what to fix before a reorder. 1. (5) Love the matte finish, feels premium. Perfect size for my morning coffee. 2. (2) Arrived with a chip on the rim. Box was flimsy. 3. (4) Nice mug but the handle is small for my fingers. 4. (1) Cracked in the dishwasher after two weeks. 5. (5) Great gift, the kraft box looks nice. 6. (3) Matte surface shows coffee stains, hard to clean. 7. (2) One of two mugs broken on arrival, packaging needs more padding. 8. (4) Holds heat well. Handle a bit tight. 9. (5) Exactly as pictured, smooth matte glaze. 10. (3) Smaller than I expected, listing should say ml too. ”
``` Review themes (10 reviews) | Theme | Praise | Complaint | Example quote (#) | | Finish / appearance | 4 | 0 | “Love the matte finish” (#1) | | Size / capacity clarity | 1 | 1 | “Smaller than I expected” (#10) | | Handle comfort | 0 | 2 | “the handle is small for my fingers” (#3) | | Packaging / transit damage | 1 | 2 | “Box was flimsy” (#2) | | Durability / breakage | 0 | 1 | “Cracked in the dishwasher” (#4) | | Cleaning / stain resistance | 0 | 1 | “hard to clean” (#6) | | Heat retention | 1 | 0 | “Holds heat well” (#8) | ``` Top fixes: 1. [SERVICE] Upgrade shipping protection and box strength; damage on arrival is the clearest repeat complaint. 2. [PRODUCT] Rework the handle or confirm a larger-grip version if possible; multiple reviews say it feels tight. 3. [LISTING] Clarify capacity in both oz and ml, and show the mug next to a hand/object for scale to reduce size surprises. Listing bullet ideas that answer real objections: - “12 oz capacity; dimensions shown in oz and ml” - “Matte finish with smooth glaze” - “Designed for comfortable daily use; check handle size in photos” - “Ships in protective packaging with extra padding” - “Best for coffee, tea, and gifting” Weak signals (1 mention): dishwasher cracking, stain resistance, heat retention, gift presentation, looks exactly as pictured.
Real, unedited output from recorded runs on Nov 2, 2026 · Codex (codex-cli 0.163.0) · model gpt-5.4-mini. Test inputs are fixtures (fictional brand, example.com links). AI output can be wrong: check facts before you publish anything like it.
Install
Unzip first. You get a folder named review-theme-miner containing SKILL.md.
Claude Code
Put the folder in your personal skills directory, or in the project to share it with your team.
~/.claude/skills/review-theme-miner/SKILL.md.claude/skills/review-theme-miner/SKILL.mdClaude Code picks up new skills in the current session (run /reload-skills if the skills folder didn't exist when the session started). The skill loads when a task matches its description.
Claude.ai
Turn on code execution (Settings → Capabilities), then go to Customize → Skills, click +, then Create skill → Upload a skill, and select the ZIP. Full guide.
Cursor
Put the folder in your user or project skills directory. Cursor also reads .claude/skills.
~/.cursor/skills/review-theme-miner/SKILL.md.cursor/skills/review-theme-miner/SKILL.mdCodex
Put the folder in your user or repository skills directory, then restart Codex or run /skills to check it is listed.
~/.agents/skills/review-theme-miner/SKILL.md.agents/skills/review-theme-miner/SKILL.mdThese are the standard skill locations for each tool. The tools a skill is verified on are listed under “Tested on” above, if any.
Test log
| Date (UTC) | Tool | Model | Run | Result | Checks | Tokens in / out |
|---|---|---|---|---|---|---|
| Nov 2, 2026 | Codex | gpt-5.4-mini | Test | Passed | 4/4
| 38,012 / 789 |
Each row is a real run recorded by our test runner. For each tool, the latest test run decides whether it appears under “Tested on”. Baseline runs do the same task with no skill installed and never count.