Jakeschincariol/replica-skill / replica-launch
replica-launch
VerifiedWrites the launch for an app clone: the landing page built on the positioning angle, pricing set against the original's public pricing and its users' complaints, and the App Store and Google Play listing linted against the stores' limits and copycat rules. Use when the user says "landing page", "pricing", "how much should I charge", "App Store listing", "store screenshots", "launch plan", "Product Hunt", or after /replica-brand.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.0 KB |
| listing.example.json | config | 1.2 KB |
| listing.py | script | 7.2 KB |
listing.py
View on GitHub#!/usr/bin/env python3
"""Store listing linter for replica-launch. Standard library only.
Checks an App Store and Google Play listing against the stores' field limits
and the mistakes that get a clone rejected: the original app's name in your
metadata, ranking claims in the title, wasted keyword characters.
python3 listing.py replica/launch/listing.json
python3 listing.py listing.json --avoid "Calendly,Acuity Scheduling"
python3 listing.py listing.json --json
listing.json (see listing.example.json):
{
"avoid": ["Original App Name", "Its Company"],
"app_store": {"name", "subtitle", "promotional_text", "description",
"keywords", "whats_new"},
"google_play": {"title", "short_description", "full_description"}
}
Leave out a store you are not shipping to. Exit code 1 on any error, 0 when
there are only warnings.
"""
import argparse
import json
import re
import sys
import unicodedata
LIMITS = {
"app_store": {"name": 30, "subtitle": 30, "promotional_text": 170,
"description": 4000, "keywords": 100, "whats_new": 4000},
"google_play": {"title": 30, "short_description": 80, "full_description": 4000},
}
SHORT_FIELDS = {"name", "subtitle", "title", "short_description"}
CLAIMS = re.compile(
r"(#\s?1\b|\bnumber one\b|\bno\.? ?1\b|\bbest\b|\btop[- ]rated\b|\b(app|game) of the year\b"
r"|\bfree\b|\bdiscount\b|\bsale\b|\b\d+% off\b|\bnew!?$)", re.I)
STOP = {"a", "an", "and", "app", "for", "the", "to", "of", "with", "your", "you", "in", "on", "&"}
def length(text):
"""Characters as a person counts them (an emoji built from parts is one)."""
text = unicodedata.normalize("NFC", text or "")
count = 0
prev_joiner = False
for ch in text:
cat = unicodedata.category(ch)
if ch == "":
prev_joiner = True
continue
if cat in ("Mn", "Me") or ch in ("️", "︎") or 0x1F3FB <= ord(ch) <= 0x1F3FF:
continue
if prev_joiner:
prev_joiner = False
continue
count += 1
return count
def has_emoji(text):
return any(unicodedata.category(ch) == "So" or ord(ch) >= 0x1F000 for ch in text or "")
def words(text):
return [w for w in re.findall(r"[a-z0-9']+", (text or "").lower()) if w not in STOP]
def lint(listing, avoid=None):
issues = []
avoid = [a.strip() for a in (avoid or listing.get("avoid") or []) if a.strip()]
def add(level, store, field, msg):
issues.append({"level": level, "store": store, "field": field, "message": msg})
found_store = False
for store, limits in LIMITS.items():
data = listing.get(store)
if not data:
continue
found_store = True
for field, limit in limits.items():
value = data.get(field, "")
n = length(value)
if not value:
level = "error" if field in ("name", "title", "description",
"full_description") else "warn"
add(level, store, field, "empty")
continue
if n > limit:
add("error", store, field, "%d characters, limit is %d (%d over)"
% (n, limit, n - limit))
for name in avoid:
if re.search(r"(?<!\w)%s(?!\w)" % re.escape(name), value, re.I):
add("error", store, field,
"mentions '%s'. Another app's name or trademark in your "
"metadata gets the listing rejected and invites a takedown. "
"Describe what yours does instead." % name)
if field in SHORT_FIELDS:
m = CLAIMS.search(value)
if m:
add("warn", store, field,
"'%s' reads as a ranking or price claim. Google Play bans "
"these in the title and short description, and Apple "
"rejects claims you cannot back up." % m.group(0).strip())
if has_emoji(value):
add("warn", store, field, "emoji in a short field. Play rejects "
"them in titles; App Store reviewers often do too.")
caps = re.findall(r"\b[A-Z]{4,}\b", value)
if caps:
add("warn", store, field, "all-caps word(s): %s" % ", ".join(caps))
if store == "app_store" and data.get("keywords"):
kw_raw = data["keywords"]
parts = [k.strip().lower() for k in kw_raw.split(",")]
if re.search(r",\s", kw_raw):
add("warn", store, "keywords", "spaces after commas waste characters. "
"Use word1,word2,word3")
dupes = sorted({k for k in parts if k and parts.count(k) > 1})
if dupes:
add("warn", store, "keywords", "repeated: %s" % ", ".join(dupes))
in_name = set(words(data.get("name", "")) + words(data.get("subtitle", "")))
wasted = sorted({w for k in parts for w in words(k) if w in in_name})
if wasted:
add("warn", store, "keywords", "already in the name or subtitle, so "
"these characters are wasted: %s" % ", ".join(wasted))
if any(not k for k in parts):
add("warn", store, "keywords", "empty entry (double comma or trailing comma)")
if not found_store:
add("error", "-", "-", "no app_store or google_play section found")
return issues
def render(listing, issues):
out = []
for store, limits in LIMITS.items():
data = listing.get(store)
if not data:
continue
out.append(store.replace("_", " ").title())
for field, limit in limits.items():
n = length(data.get(field, ""))
mark = "OVER" if n > limit else ("ok" if n else "--")
out.append(" %-18s %5d / %-5d %s" % (field, n, limit, mark))
out.append("")
if not issues:
out.append("No issues.")
for i in issues:
out.append("%-5s %s.%s: %s" % (i["level"].upper(), i["store"], i["field"],
i["message"]))
errs = sum(1 for i in issues if i["level"] == "error")
warns = len(issues) - errs
out.append("")
out.append("%d errors, %d warnings" % (errs, warns))
return "\n".join(out)
def main(argv=None):
ap = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
ap.add_argument("listing", help="listing.json")
ap.add_argument("--avoid", help="comma-separated names that must not appear "
"(the original app, its company)")
ap.add_argument("--json", action="store_true")
args = ap.parse_args(argv)
try:
with open(args.listing, encoding="utf-8") as fh:
listing = json.load(fh)
except (OSError, ValueError) as exc:
print("listing: %s" % exc, file=sys.stderr)
return 2
avoid = args.avoid.split(",") if args.avoid else None
issues = lint(listing, avoid)
if args.json:
print(json.dumps(issues, indent=2))
else:
print(render(listing, issues))
return 1 if any(i["level"] == "error" for i in issues) else 0
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |