Skip to main content

replica-entrepreneur

Fleet adaptation — tools (security vet, 2026-10-10)​

Imported under the security desk's CLEAR-WITH-CONDITIONS verdict (repo read in full at the pin; the pack's tools verified stdlib-only and no-network, test suite green including with socket creation disabled). The Python tools are adopted as runnable, locally only: they run on project-local artifacts the operator produced.

Fleet adaptation — collection rules (security vet, 2026-10-10)​

The collection this skill describes follows its own rules as fleet rules: public sources and the owner's own accounts only, human-speed reading, official feeds used within their terms.

A straight copy of an app has no reason to exist. This skill finds the reason: what the original's users hate, in their own words, and fixes it in yours.

Tool in this folder:

python3 reviews.py replica/reviews.csv --out replica/feedback.md

The rules, which are not negotiable​

  • Never fabricate. No invented reviews, quotes, ratings, counts, users or sources. If a source cannot be reached, say so and move on. If there are 14 reviews, say 14.
  • Every quote is verbatim and linked. Copied exactly from the page, with the URL of the review or thread. reviews.py drops any row without a link.
  • Reading, not scraping. Read review pages the way a person does, in the browser, and copy rows into the sheet. No scraping libraries against stores or review sites whose terms forbid it. Official public feeds and APIs are fine within their terms: Apple's customer reviews RSS feed (https://itunes.apple.com/us/rss/customerreviews/id=<APP_ID>/sortBy=mostRecent/json), the Hacker News Algolia API (hn.algolia.com/api/v1/search?query=...), Reddit's official API under its terms.
  • No fake reviews, ever. Not for your app, not against theirs. It is illegal in the US (the FTC's 2024 rule) and in many other places.
  • Reviewers are not your testimonials. Their words are research. Do not put them on your landing page.

Step 1: collect​

Aim for 100+ reviews across at least three sources, recent first:

sourcewhere
App Storethe app page, Ratings and Reviews, See All; or the RSS feed above
Google Playthe listing, See all reviews, sort by newest
G2, Capterra, Trustpilotthe product's review pages, filter to 1 to 3 stars too
Redditsearch "X alternative", "switched from X", "X sucks", "X vs"
Hacker Newsthe Algolia API or site search, same queries
the original's own boardits public roadmap or feature-request board (Canny and similar) and the vote counts
its changelogwhat it shipped, so you do not "fix" what is already fixed

Each row in replica/reviews.csv: source,url,date,rating,text, text copied exactly. Read the 3 and 4 star reviews too. "Love it, but..." is where the best fixes hide.

Step 2: rank​

python3 reviews.py replica/reviews.csv --out replica/feedback.md

It sorts reviews into themes (themes.json, edit it for the app's category), weights low ratings and recent reviews higher, marks themes with fewer than 3 reviews or only one source as thin, lists every request in the users' own words, and surfaces low ratings that matched no theme. Read that last list by hand. It is often the best part.

Step 3: three lists​

From feedback.md, write three ranked lists. Each item: the problem in one line, how many reviews, how many sources, one or two linked quotes.

  1. What they hate. Complaints about things the app does.
  2. What is missing. Features people ask for by name.
  3. What is unsolved. Whole jobs or groups the app ignores ("not built for teams", "useless for therapists"). These become positioning.

Thin themes are listed as thin. Do not present three angry Reddit comments as a trend.

Step 4: the fix plan​

Pick the top 5 to 8 by evidence times how cheaply you can fix them. For each: what to build or change, size (S, M, L), which skill does it, and the evidence. Add each one to replica/features.csv as a row with original set to no. Pricing and billing complaints go to /replica-launch.

Step 5: the angle​

Three positioning options, each grounded in a top theme:

For {{who}} who {{hate this about the original, in plain words}},
{{your app}} {{does this instead}}.
Evidence: {{theme}}, {{n}} reviews across {{n}} sources.

Recommend one. It drives replica-brand's name and voice and replica-launch's hero. Do not put the original's name in your app name, ads or store listing. A factual comparison page is a legal question for a lawyer in your country.

Output​

replica/reviews.csv, replica/feedback.md, replica/fixes.md (three lists, fix plan, angle), new rows in features.csv, and a summary that states the sample size. Next: /replica-brand.

Supporting files: this skill's supporting files are held in the docsite at docs/15-skills/_support/replica/replica-entrepreneur/ — fetch them fresh from jknash/docsite main alongside this page.

Source: Jakeschincariol/replica-skill · replica-entrepreneur/ @ 77c9436fb3d18c3d58169efb8caf4fe906b0dc51 · view source · Imported 2026-10-10 under the owner's directive (public-repo content approved for internal fleet use; MIT). Tools and method imported; the pack’s Python tools are adopted as RUNNABLE locally under the security vet’s conditions (CLEAR-WITH-CONDITIONS, 2026-10-10). Any upstream upgrade re-opens the vet for the changed surface.