Skip to main content
skill CX Codex

seed-scout — Claude Code skill: competitor review analysis

The seed-scout Claude Code skill examines competitors’ App Store reviews and groups recurring complaints. It runs for competitor research based on an idea or before drafting a plan and pitch deck.

MIT ★ 197 updated 2026-11-01

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Jakeschincariol/seed-skill
/plugin install seed-skill@seed-skill
Open on GitHub

What seed-scout does

The skill searches for apps from a short description of an idea, reads recent App Store reviews, and sorts one- and two-star feedback into themes such as pricing, cancellations, support, bugs, and payments. When comparing apps, it surfaces the complaint that distinguishes one rival from the others and backs it with review counts.

Reviews go into seed/reviews/, while comparison results are written to seed/competitors.json for other parts of the toolkit to use in a plan or deck. It needs python3 and access to the iTunes Search API, iTunes Lookup API, and customer-review RSS feeds. These sources are free and require no key. Theme matching relies on keywords, so sarcasm and accidental matches need to be checked against the original reviews.

What it helps with

  • find rival apps from a short product idea
  • sort low ratings into complaint themes
  • compare the weak points of several apps
  • save findings for a plan or pitch deck

Example prompts for the agent

  • Find competing apps for a dog-walking service
  • Compare reviews for apps 547320928 and 940734609
  • Analyze reviews for 547320928 and save the results

How to install seed-scout

1Plugin marketplace

/plugin marketplace add Jakeschincariol/seed-skill
/plugin install seed-skill@seed-skill

This installs the whole seed-skill plugin with all its skills

2Skills CLI (Vercel)

npx skills add Jakeschincariol/seed-skill --skill seed-scout -a claude-code

3Manually: put the files in place

~/.claude/skills/seed-scout/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seed-scout/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seed-scout

How do I install seed-scout in Claude Code?

Add the marketplace with /plugin marketplace add Jakeschincariol/seed-skill, then install the skill with /plugin install seed-skill@seed-skill.

What does seed-scout do?

It finds apps related to an idea, analyzes recent App Store reviews, and groups common complaints. Comparisons are saved to seed/competitors.json.

What does seed-scout need to run?

It needs python3 and access to the iTunes Search API, iTunes Lookup API, and customer-review RSS feeds. These sources are free and require no key.

Source text

SKILL.md · MIT
---
name: seed-scout
description: >-
  Competitor Scout. Finds the weak points of your competitors in their own
  App Store reviews: searches the App Store for the apps people already use
  for your idea, reads up to the 500 most recent reviews of each, sorts the
  one- and two-star ones into themes (fees and pricing, cancellations and
  no-shows, support, bugs, trust and safety, payments and refunds,
  availability), and names each rival's weak point with the evidence ("106
  of 341 recent 1-2 star reviews mention fees"). Writes seed/reviews/ and
  seed/competitors.json for the plan, the deck and the pitch coach. Use when
  the user says "who are my competitors", "find my competitors' weak
  points", "what do people hate about Rover", "read their reviews", "scout
  the competition", "competitor research", "why do customers leave X", or at
  the start of a raise, before /seed-market.
argument-hint: "[\"your idea in a few words\" | APP_ID ...]"
---

# seed-scout

The Competitor Scout finds the gap you can win in. People who already pay a
rival tell the App Store exactly what is wrong with it, in public, every day.
This skill reads those reviews in bulk, counts what the angry ones complain
about, and turns that into one plain sentence per rival that a business plan
and a pitch deck can stand on. It reports what reviewers wrote and how often.
It never makes a complaint up, and it never calls a rival bad in general.

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/scout.py" find "dog walking"                   # the apps people find for the idea
python3 "${CLAUDE_SKILL_DIR}/scout.py" reviews 547320928 --write            # 500 most recent -> seed/reviews/
python3 "${CLAUDE_SKILL_DIR}/scout.py" reviews "Wag" --write                # a name works: it says which app it picked
python3 "${CLAUDE_SKILL_DIR}/scout.py" themes 547320928                     # what the 1-2 star reviews say
python3 "${CLAUDE_SKILL_DIR}/scout.py" compare 547320928 940734609 --write  # weak points -> seed/competitors.json
python3 "${CLAUDE_SKILL_DIR}/scout.py" pricing 547320928 --note "keeps 20% of each booking" --source URL --write
python3 "${CLAUDE_SKILL_DIR}/scout.py" show
```

Other flags: `--pages 1..10` (50 reviews a page), `--stars 1` (one-star
only), `--by count` (the most mentioned theme instead of the gap), `--rules
FILE` (your own themes), `--country gb`, `--dir`, `--json`, `--today`,
`--offline DIR` (saved responses, for testing).

## What it reads and writes

| file / feed | what |
| --- | --- |
| iTunes Search API | `find`, and turning a name into an app id. Free, no key, not an official API |
| iTunes Lookup API | each app's rating, rating count and full name |
| customer-reviews RSS | `.../rss/customerreviews/page=N/id=APP_ID/sortby=mostrecent/json`: 50 a page, 10 pages, so the 500 most recent reviews in one country |
| `seed/reviews/<app_id>.json` | with `--write`: the reviews read (date, stars, title, text, version; no reviewer names) |
| `seed/competitors.json` | `compare --write`: one row per app with `themes`, `top_theme`, `weak_point`, `weak_point_line`, `examples`, the rating and the source. `/seed-plan`, `/seed-deck` and `/seed-coach` read it |

## How the themes and the weak point work

- **Low reviews** are the one- and two-star ones (`--stars` changes it). M in
  "N of M" is how many of those were read, N how many mention the theme.
- **Keyword rules**, on the title and the text, case-insensitive. A review can
  hit several themes. The rules are listed at the top of `scout.py`; `--rules
  FILE` adds themes for another industry (`{"key": {"label", "patterns"}}`).
- **The weak point** of each app, when you compare two or more: the theme that
  sets it apart, its share of low reviews minus the pooled share of the other
  apps. Support complaints show up for every app, so they rarely win; a
  complaint one rival gets far more than the others does. A theme needs at
  least 5% of the app's low reviews to count. With one app, or `--by count`,
  it is the most mentioned theme. The output says when the two differ.
- **Rounding.** The rating rounds half up to one decimal (4.88527 is 4.9).
  Shares are one decimal. Counts are exact.
- **Polite.** One request at a time, a one-second pause between pages, a
  20-second timeout, a User-Agent that names this project.

## Steps

1. Ask for the idea in a few words, the way a customer would search for it.
   Run `scout.py find "<words>"` and pick the two to four real rivals (the
   most ratings, the same job). Confirm the list with the user.
2. Run `scout.py reviews APP_ID --write` for each one.
3. Run `scout.py compare APP_ID APP_ID ... --write`. Read every rival's
   weak point, its evidence line and its examples.
4. **Read the examples before you quote a theme.** Keyword rules miss
   sarcasm and catch the odd false hit. If a theme looks wrong, open
   `seed/reviews/<id>.json`, read the matching reviews and say what you saw.
5. **Read each rival's pricing page by hand.** Search for "<rival> fees" or
   "<rival> pricing", open the rival's own help or pricing page, and write
   down what it actually charges with `scout.py pricing APP_ID --note "..."
   --source URL --write`. A fee you cannot link to stays out of the plan.
6. Tell the user, per rival: the rating and rating count, the weak point,
   "N of M recent 1-2 star reviews mention it", and the pricing note with
   its link. Then say the gap in one line: what the new product does about
   it.
7. Hand off to `/seed-market` to size the market, then `/seed-model` and
   `/seed-plan`, which pull `seed/competitors.json` into the Competition
   section. `/seed-coach` turns it into the questions investors will ask.

## Example: the reel

Leashly (a made-up startup: "a dog-walking app with flat prices and a backup
walker on every walk"). On October 25, 2026 the scout read the 500 most
recent US reviews of Rover and of Wag!. `scout.py compare 547320928
940734609 --write`:

```
Competitors: their most recent App Store reviews, 1-2 star only
  app            rating    ratings  low/read   weak point                  evidence
  Rover             4.9    515,771   341/500   fees and pricing            106 of 341 (31.1%)
  Wag!              4.8     67,447   324/500   cancellations and no-shows  81 of 324 (25.0%)
Weak point = the complaint that sets each app apart: its share of low reviews minus the others'.
  Wag!: the most mentioned is customer support (95 of 324), but the other apps get it about as often.
```

Rover's fee share is 31.1% against Wag!'s 24.7%, a 6.4 point gap.
Wag!'s cancellation share is 25.0% against Rover's 12.3%, a 12.7 point gap.
The pricing note comes from Rover's own help center: Rover keeps 20% of
each sitter booking and adds a service fee for owners at checkout. That is
Leashly's story: flat $25 walks with no surprise fees, and a backup walker
on every walk.

## Rules

- Quote counts as "N of M recent 1-2 star reviews mention X", with the
  date read. Never "everyone hates X".
- Reviews are what reviewers wrote, not facts about the company. Pricing
  claims come from the rival's own page, with its URL.
- Never copy a stranger's review into a deck or an email. Titles in the
  plan are fine as evidence; the full texts stay in `seed/reviews/`.
- Never log in to the App Store or anywhere else. These feeds are public.

## What it never does

It never invents a review, a rating or a fee, never posts a review, never
contacts a competitor or a reviewer, and never says a rival is failing. A
weak point is where customers complain most, compared with the others.

© Jake Schincariol · MIT · Jakeschincariol/seed-skill

Similar skills

All skills for Marketing and content →

From the same set12

The whole set →
seed-updates The seed-updates Claude Code skill drafts monthly investor updates with metric changes and a runway calculation. It can also prepare a shorter version for prospects who previously said “not now.” CX Codex +1 ★ 197repo stars seed-deck The seed-deck Claude Code skill turns a business plan into a 10-slide pitch deck. It creates an HTML presentation and checks its content and figures. CX Codex +1 ★ 197repo stars seed-terms The seed-terms Claude Code skill calculates ownership and dilution from SAFE and priced-round terms. It runs when asked to assess a deal or flag clauses for legal review. CX Codex +1 ★ 197repo stars seed-plan The seed-plan Claude Code skill builds a nine-section business plan from a startup idea. It runs when asked to draft or check a plan, work out unit economics, or prepare for /seed-deck. CX Codex +1 ★ 197repo stars seed-model seed-model — a Claude Code skill that builds a 36-month financial model from business assumptions. It runs for questions about runway, break-even, fundraising, or before /seed-plan and /seed-deck. CX Codex +1 ★ 197repo stars seed-investors The seed-investors Claude Code skill finds investors for a startup and scores their fit. It runs on requests to find or rank investors, after /seed-plan and before /seed-closer. CX Codex +1 ★ 197repo stars seed-closer The seed-closer Claude Code skill drafts personalised investor emails and tracks replies through to a booked call. It responds to requests to send outreach, sort replies, or arrange a meeting. CX Codex +1 ★ 197repo stars seed-skill This Claude Code plugin brings together 11 skills for preparing a startup to raise a seed round. They cover competitor research, investor outreach, financial planning and pitch preparation. ★ 197repo stars

Project sponsors

Companies that keep this analytics open