agentleFS
motion-teammotion-team/creative-strategy-skills/review-audit/SKILL.md

review-audit

Skill177 starsChanged 8 months agoMITView on GitHub

Analyzes positive customer reviews to surface deep customer insights for ad copy. Use this whenever a user provides customer reviews and wants to understand their customers better, extract VOC (voice of customer), find ad-ready language, or build messaging strategy from real customer language. Trigger for any request involving "analyze these reviews," "what are customers saying," "find insights in these reviews," "VOC analysis," or any variation of wanting to mine customer reviews for creative strategy inputs. Output is always organized by product (if multiple), and surfaces five buckets of insight: pain points, trigger moments, objections, transformations, and standout language.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. dualform-labs/review-audit★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository7 other files it gives its agents.

The file

Show its rules and text

We split this skill into the rules it gives an agent

16 rules. About 0 are common, 16 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈16

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If multiple products are present in the review set, identify them before beginning.

    line 21
  2. Distinctive:

    If the format is unclear or product attribution is ambiguous, ask before proceeding.

    line 23
  3. Distinctive:

    If the brand sells multiple products, sort all reviews by product first.

    line 29
  4. Distinctive:

    If all reviews are for a single product, skip grouping and proceed.

    line 31
  5. Distinctive:

    Before analysis, score every review for quality.

    line 37
  6. Distinctive:

    Run this analysis separately for each product.

    line 61
  7. Distinctive:

    Do not editorialize the quotes.

    line 63
  8. Distinctive:

    Look for: descriptions of the problem they had, how long they'd had it, what they'd tried before, how it affected their life, the emotional …

    line 70
  9. Distinctive:

    Write a 2–3 sentence summary of the pattern across reviews

    line 74
  10. Distinctive:

    Write a 2–3 sentence summary of the pattern

    line 86
  11. Distinctive:

    Look for: skepticism they mention having had, comparisons to other products they'd tried, price hesitation, disbelief that this would …

    line 94
  12. Distinctive:

    Look for: the specific result they experienced, how their life is different now, the emotional shift (confidence, relief, freedom, pride), …

    line 108
  13. Distinctive:

    Before/after language that is visceral and concrete

    line 127
  14. Distinctive:

    All word-for-word quotes are collected in Bucket 5.

    line 184
  15. Distinctive:

    If the review set is small (under 20 reviews), note this — patterns may not be statistically meaningful but language is still usable

    line 204
  16. Distinctive:

    If a product has too few quality reviews to surface meaningful patterns, flag it rather than manufacturing themes that aren't there

    line 205

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Review Audit

This system mines positive customer reviews to extract the insights that make ad copy actually work — the real language, real pain, real moments, and real transformations that customers experienced. The output feeds directly into creative strategy and hook writing.

The goal is not to summarize reviews. The goal is to find the raw material for ads.


What You Need Before Starting

Reviews can be provided in any format:

  • Pasted directly into the chat
  • CSV or spreadsheet upload
  • Copy/pasted from a document

If multiple products are present in the review set, identify them before beginning. All output is separated by product.

If the format is unclear or product attribution is ambiguous, ask before proceeding.


Step 1: Group by Product

If the brand sells multiple products, sort all reviews by product first. Every subsequent step runs separately per product.

If all reviews are for a single product, skip grouping and proceed.


Step 2: Score Review Quality (1–5)

Before analysis, score every review for quality. This determines what gets analyzed and what gets discarded.

ScoreWhat it looks like
1Garbage — gibberish, swear words, 2–3 meaningless words, zero signal ("great product", "love it", "👍")
2Low signal — very short, vague, no specific detail or emotion
3Moderate — mentions the product, some specificity, but no vivid detail or emotional depth
4High quality — specific, describes a real experience, references a before/after or a feeling
5Gold — long, emotional, vivid, paragraph-level detail; the customer was so moved they wrote an essay about it

Score 5 reviews are the priority. They contain the most usable language and the deepest insight.


Step 3: Filter

Discard all reviews scored 1. Do not include them in analysis.

Analyze scores 2–5, with emphasis on 4s and 5s. Low-scoring reviews (2–3) can contribute to pattern identification but should not be the source of pulled quotes.


Step 4: Extract Insights by Bucket

Run this analysis separately for each product. Within each bucket, group similar insights together and write a brief summary of the pattern. Then pull the best word-for-word quotes that exemplify it.

Do not editorialize the quotes. Pull them exactly as written.


Bucket 1: Pain Points

What problem were they experiencing before they found this product?

Look for: descriptions of the problem they had, how long they'd had it, what they'd tried before, how it affected their life, the emotional weight of living with it.

For each pain theme identified:

  • Name the theme
  • Write a 2–3 sentence summary of the pattern across reviews
  • Flag the strongest quotes for the swipe file

Bucket 2: Trigger Moments

What finally made them buy?

Look for: the specific moment, event, or realization that pushed them over the edge. This is the thing that turned a maybe into an add-to-cart. It could be a life event (wedding, diagnosis, vacation), a recommendation (friend, doctor, TikTok), hitting a breaking point, or running out of patience with other solutions.

For each trigger theme identified:

  • Name the theme
  • Write a 2–3 sentence summary of the pattern
  • Flag the strongest quotes for the swipe file

Bucket 3: Objections Before Purchasing

What almost stopped them from buying?

Look for: skepticism they mention having had, comparisons to other products they'd tried, price hesitation, disbelief that this would actually work, fear of wasting money again.

Note: In positive reviews, objections are almost always mentioned in past tense — "I was skeptical but..." or "I almost didn't try it because..." These are gold for objection-handling ad copy.

For each objection theme identified:

  • Name the theme
  • Write a 2–3 sentence summary of the pattern
  • Flag the strongest quotes for the swipe file

Bucket 4: Transformations

What changed for them after using the product?

Look for: the specific result they experienced, how their life is different now, the emotional shift (confidence, relief, freedom, pride), and — most importantly — how they describe the transformation in their own words. The more specific and visceral, the better.

For each transformation theme identified:

  • Name the theme
  • Write a 2–3 sentence summary of the pattern
  • Flag the strongest quotes for the swipe file

Bucket 5: Standout Language & Ad-Ready Phrases

Exact language worth stealing for ads.

This bucket is different from the others. It is not organized by theme — it is a curated collection of the most vivid, emotionally charged, specific, and scroll-stopping phrases pulled from across all buckets. These are the lines that made you stop while reading. The ones that don't need to be rewritten. The ones a copywriter would highlight and build an ad around.

Pull these verbatim. Note which product they're from.

What to look for:

  • Unusually specific descriptions of pain or transformation
  • Phrases that capture an emotion in a way you couldn't have written yourself
  • Before/after language that is visceral and concrete
  • Lines that could work as a hook with zero editing
  • Anything that made you feel something while reading it

Output Format

Produce a separate full output for each product. Structure:

─────────────────────────────────────
PRODUCT: [Product Name]
Reviews analyzed: [X] | Discarded (score 1): [X]
─────────────────────────────────────

BUCKET 1: PAIN POINTS

[Theme Name]
Summary: [2–3 sentences on the pattern]

[Theme Name]
Summary: [2–3 sentences on the pattern]

---

BUCKET 2: TRIGGER MOMENTS

[Theme Name]
Summary: [2–3 sentences on the pattern]

---

BUCKET 3: OBJECTIONS BEFORE PURCHASING

[Theme Name]
Summary: [2–3 sentences on the pattern]

---

BUCKET 4: TRANSFORMATIONS

[Theme Name]
Summary: [2–3 sentences on the pattern]

---

BUCKET 5: STANDOUT LANGUAGE & AD-READY PHRASES

"[Exact quote]"
"[Exact quote]"
"[Exact quote]"
[etc.]

─────────────────────────────────────

All word-for-word quotes are collected in Bucket 5. Do not scatter quotes throughout buckets 1–4 — keep the summaries clean and let the swipe file be the dedicated place for raw language.


How This Feeds the Rest of the Stack

The output of this analysis plugs directly into creative strategy and execution:

  • Pain Points → Creative Strategy Engine — pain buckets map directly to the pain/desire anchor layer
  • Trigger Moments → Hook Writing — trigger moments are often the most powerful hook material; they capture the exact moment of emotional readiness
  • Objections → Hook Writing / Creative Mechanics — objections inform Borrowed Enemy, Reframe, and Risk Reversal mechanics and hook tactics
  • Transformations → Hook Writing — transformation language feeds aspirational and social proof hooks
  • Standout Language → Hook Voice Patterns — the best phrases can be added directly to the swipe file as native voice patterns pulled from real customers

Notes on Quality

  • Score 5 reviews should be read in full and treated as primary sources
  • Score 2–3 reviews are useful for pattern confirmation but not quote sourcing
  • If the review set is small (under 20 reviews), note this — patterns may not be statistically meaningful but language is still usable
  • If a product has too few quality reviews to surface meaningful patterns, flag it rather than manufacturing themes that aren't there

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.