← All skills

🧰 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.

E-commerceBeginner · Copy and use. No edits needed.FreePublished Nov 2, 2026
Tested on✓ CodexSee test log
Free download

ZIP with SKILL.md and any reference files.

Download ZIP

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. ”

AFTER · with the skill
```
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.md

Claude 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.md

Codex

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.md

These 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)ToolModelRunResultChecksTokens in / out
Nov 2, 2026Codexgpt-5.4-miniTestPassed
4/4
  • ✓ codex exited cleanly
  • ✓ skill was loaded (SKILL.md read)
  • ✓ output has substance (80+ words) (247 words)
  • ✓ no obvious secret leak
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.