Systems Lab

Agent skill

ad-angle-miner

Mine the highest-converting ad angles from customer reviews, Reddit complaints, support tickets, and competitor ads.

dormantNeeds a keyActs undeclared1,146 words

Filed under ABM and paid.

From edupegoretti/fluidz-skills · 116 skills · 0 · pushed 2026-03-11

What it does when it runs

Mine the highest-converting ad angles from customer reviews, Reddit complaints, support tickets, and competitor ads. Extracts actual pain language, competitor weaknesses, and outcome phrases that real buyers use. Outputs a ranked angle bank with proof quotes and recommended ad formats per angle.

Read from the skill and the 1 file bundled beside it. A skill’s own description is written to be selected by an agent, so it describes the job and not the dependencies.

Keys and connectors you must supply
  • APIFY_API_TOKEN
Hosts it reaches
No third-party host appears in the skill or its bundled files.
Tool permissions it declares
No allowed-tools in the frontmatter. It does act, so it runs under whatever permissions your session already grants.
Actions present in the files
shellwrites files

Ask about ad-angle-miner

Opens your assistant with this page's verified links already in the prompt.

Is this safe to install?ClaudeChatGPT
Adapt it to my stackClaudeChatGPT
What else do I need for it to workClaudeChatGPT
Rather ask a human? Talk to Cheetah
git clone --depth 1 --filter=blob:none --sparse https://github.com/edupegoretti/fluidz-skills.git /tmp/fluidz-skills
git -C /tmp/fluidz-skills sparse-checkout set "skills/composites/ad-angle-miner"
mkdir -p ~/.claude/skills/ad-angle-miner
cp -R "/tmp/fluidz-skills/skills/composites/ad-angle-miner/." ~/.claude/skills/ad-angle-miner/

Picked up without a restart. A project skill of the same name is shadowed by your personal one. For one repository only, swap ~/.claude/skills for .claude/skills. Claude Code docs ↗

The folder is the same in every client that implements the format — 46 of them — so if yours is not above, only the destination changes.

Before you install: this skill will not complete its job on a bare agent. It needs APIFY_API_TOKEN, which you have to obtain separately.

Reproduced in full from edupegoretti/fluidz-skills/blob/a2cf697e2e8ec2ea517d85496e2d5c7f5dc44cd3/skills/composites/ad-angle-miner/SKILL.md, which is licensed MIT (repository). 1,146 words, 27 headings.

Ad Angle Miner

Dig through customer voice data — reviews, Reddit, support tickets, competitor ads — to extract the specific language, pain points, and outcome desires that make ads convert. The output is an angle bank your team can pull from for any campaign.

Core principle: The best ad angles aren't invented in a brainstorm. They're extracted from what real people are already saying. This skill finds those angles and ranks them by strength of evidence.

When to Use

  • "What angles should we run in our ads?"
  • "Find pain points we can use in ad copy"
  • "What are people complaining about with [competitors]?"
  • "Mine reviews for ad messaging"
  • "I need fresh ad angles — not the same tired stuff"

Phase 0: Intake

  1. Your product — Name + what it does in one sentence
  2. Competitors — 2-5 competitor names (for review mining)
  3. ICP — Who are you targeting? (role, company stage, pain)
  4. Data sources to mine (pick all that apply):
    • G2/Capterra/Trustpilot reviews (yours + competitors)
    • Reddit threads in relevant subreddits
    • Twitter/X complaints or praise
    • Support tickets or NPS comments (paste or file)
    • Competitor ads (Meta + Google)
  5. Any angles you've already tested? — So we can skip those

Phase 1: Source Collection

1A: Review Mining

Run review-scraper for your product and each competitor:

python3 skills/review-scraper/scripts/scrape_reviews.py \
  --product "<product_name>" \
  --platforms g2,capterra \
  --output json

Focus on:

  • 1-2 star reviews of competitors — Pain they're failing to solve
  • 4-5 star reviews of you — Outcomes that delight buyers
  • 4-5 star reviews of competitors — Strengths you need to counter or match
  • Review language patterns — Exact phrases buyers use

1B: Reddit/Community Mining

Run reddit-scraper for relevant subreddits:

python3 skills/reddit-scraper/scripts/scrape_reddit.py \
  --query "<product category> OR <competitor> OR <pain keyword>" \
  --subreddits "<relevant_subreddits>" \
  --sort relevance \
  --time month \
  --limit 50

Extract:

  • Questions people ask before buying
  • Complaints about current solutions
  • "I wish [product] would..." statements
  • Comparison threads (vs discussions)

1C: Twitter/X Mining

Run twitter-scraper:

python3 skills/twitter-scraper/scripts/scrape_twitter.py \
  --query "<competitor> (frustrating OR broken OR hate OR love OR switched)" \
  --max-results 50

1D: Competitor Ad Mining (Optional)

Run ad-creative-intelligence to see what angles competitors are currently using. This reveals:

  • Angles they've validated (long-running ads = working)
  • Angles they're testing (new ads)
  • Angles nobody is running (white space)

1E: Internal Data (Optional)

If the user provides support tickets, NPS comments, or sales call transcripts — ingest and tag with the same framework below.

Phase 2: Angle Extraction

Process all collected data through this extraction framework:

Angle Categories

CategoryWhat to Look ForAd Power
Pain anglesSpecific frustrations with status quo or competitorsHigh — pain motivates action
Outcome anglesDesired results buyers describe in their own wordsHigh — positive aspiration
Identity anglesHow buyers describe themselves or want to be seenMedium — emotional resonance
Fear anglesRisks of NOT switching or actingMedium — loss aversion
Competitive displacementSpecific reasons people switched from a competitorVery high — direct comparison
Social proof anglesOutcomes or metrics buyers cite in reviewsHigh — credibility
Contrast anglesBefore/after or old way/new way framingsHigh — clear value prop

For Each Angle, Extract:

  1. The angle — One-sentence framing
  2. Proof quotes — 2-5 verbatim quotes from sources
  3. Source count — How many independent sources mention this?
  4. Competitor weakness? — Does this exploit a specific competitor's gap?
  5. Emotional register — Frustration / Aspiration / Fear / Relief / Pride
  6. Recommended format — Search ad / Meta static / Meta video / LinkedIn / Twitter

Phase 3: Scoring & Ranking

Score each angle on:

FactorWeightDescription
Evidence strength30%Number of independent sources mentioning it
Emotional intensity25%How strongly people feel about this (language intensity)
Competitive differentiation20%Does this set you apart, or could any competitor claim it?
ICP relevance15%How closely does this match the target buyer's world?
Freshness10%Is this angle already overused in competitor ads?

Total score out of 100. Rank all angles.

Phase 4: Output Format

# Ad Angle Bank — [Product Name] — [DATE]

Sources mined: [list]
Total angles extracted: [N]
Top-tier angles (score 70+): [N]

---

## Tier 1: Highest-Conviction Angles (Score 70+)

### Angle 1: [One-sentence angle]
- **Category:** [Pain / Outcome / Identity / Fear / Displacement / Proof / Contrast]
- **Score:** [X/100]
- **Emotional register:** [Frustration / Aspiration / etc.]
- **Proof quotes:**
  > "[Verbatim quote 1]" — [Source: G2 review / Reddit / etc.]
  > "[Verbatim quote 2]" — [Source]
  > "[Verbatim quote 3]" — [Source]
- **Source count:** [N] independent mentions
- **Competitor weakness exploited:** [Competitor name + specific gap, or "N/A"]
- **Recommended formats:** [Search ad headline / Meta static / Video hook / etc.]
- **Sample headline:** "[Draft headline using this angle]"
- **Sample body copy:** "[Draft 1-2 sentence body]"

### Angle 2: ...

---

## Tier 2: Worth Testing (Score 50-69)

[Same format, briefer]

---

## Tier 3: Emerging / Low-Evidence (Score < 50)

[Brief list — angles with potential but insufficient evidence]

---

## Competitive Angle Map

| Angle | Your Product | [Comp A] | [Comp B] | [Comp C] |
|-------|-------------|----------|----------|----------|
| [Angle 1] | Can claim ✓ | Weak here ✗ | Also claims | Not relevant |
| [Angle 2] | Strong ✓ | Strong | Weak ✗ | Not relevant |
...

---

## Recommended Test Plan

### Week 1-2: Test Tier 1 Angles
- [Angle] → [Format] → [Platform]
- [Angle] → [Format] → [Platform]

### Week 3-4: Test Tier 2 Angles
- [Angle] → [Format] → [Platform]

Save to clients/<client-name>/ads/angle-bank-[YYYY-MM-DD].md.

Cost

ComponentCost
Review scraper (per product)~$0.10-0.30 (Apify)
Reddit scraper~$0.05-0.10 (Apify)
Twitter scraper~$0.10-0.20 (Apify)
Ad scraper (optional)~$0.40-1.00 (Apify)
AnalysisFree (LLM reasoning)
Total~$0.25-1.60

Tools Required

  • Apify API tokenAPIFY_API_TOKEN env var
  • Upstream skills: review-scraper, reddit-scraper, twitter-scraper
  • Optional: ad-creative-intelligence (for competitor ad angles)

Trigger Phrases

  • "Mine ad angles from reviews"
  • "What angles should we run?"
  • "Find pain language for our ads"
  • "Build an ad angle bank for [client]"
  • "What are people complaining about with [competitor]?"

Files bundled with it

These load only when the skill asks for them, so they cost nothing until it runs.

Need help setting it up?

This page tells you what ad-angle-miner does and what it needs. Cheetah builds the agent setup it runs inside: data, CRM, sequencing and the guardrails.

Book a call →

The directory stays free. There is nothing gated behind this.