Files
skills/public/aso.html
zeekayandHanzo Dev 65c3b27843 160 marketing, growth and PM skills, on our own connectors
Four MIT collections ported — growthOS, openclaw-marketing-skills,
Marketing-Skills and pm-skills — as 160 skills, 12 agents and 45
commands, each naming its origin in its own frontmatter so the tree can
be checked against THIRD_PARTY_NOTICES rather than trusted. Sixteen names
appeared in more than one collection and none of the copies were
identical; the longest wins, which lands on the more developed text where
they genuinely diverge.

A fifth collection is deliberately absent. awesome-growth-hacking-skills
carries NO licence, which leaves its author every right by default — and
it is a list of links rather than a collection of skills, so there is
nothing in it to port and no permission to port it with. It is cited as a
directory to read.

THE CONNECTOR SKILLS ARE REWRITTEN, not ported. They arrived installing
vendor SDKs, running OAuth flows of their own, and ending with long-lived
credentials in JSON files under .agents/ and ~/.growthos/ at mode 600.
That is a secret on a disk with no rotation path, protected from other
users and not from the agent — and one auth implementation per skill.
Hanzo holds these connectors in Go, per user, sealed in KMS, so `connect`
is the one home for the flow and the platform skills defer to it by
provider id: google_ads, meta_ads, x. It is reachable as HTTP or as MCP
tools at api.hanzo.ai/v1/mcp — the same routes, typed once in Go, so a
tool and a curl cannot disagree.

Two had nothing real behind them and now say so. There is no
search_console provider, so that skill names what does answer the same
questions (google_analytics, google_bigquery) and states that the remedy
is a provider in hanzoai/cloud rather than a vendor SDK here. And
getxapi-connect was a wrapper around a paid reseller of X's public data
with the vendor's key in an env var; it is `listen` now, on our own x
connector — a skill named after a vendor makes the vendor the capability
and dies with it.

The skills referenced paths that only existed inside the source repo, so
the shared material they read is ported to reference/ and the paths
rewritten. Three skills need the growthOS APPLICATION rather than its
data; per the estate's own split an application belongs in hanzoai/ads,
social, email or sms as a cloud plugin, so those three say what they need
instead of carrying an import that resolves to nothing.

Third-party product names are out of our prose and kept in the notices,
which is where the licence requires them and the only place they belong.
A skill's persona names a role, not somebody else's product.


Co-authored-by: Hanzo Dev <[email protected]>
2026-09-15 01:27:26 -07:00

300 lines
29 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>aso</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/aso.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/aso">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/aso.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>aso</h1><p class="lede">When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions &#x27;ASO audit,&#x27; &#x27;app store optimization,&#x27; &#x27;optimize my app listing,&#x27; &#x27;improve app visibility,&#x27; &#x27;app store ranking,&#x27; &#x27;audit my listing,&#x27; &#x27;why aren&#x27;t people downloading my app,&#x27; &#x27;improve my app conversion,&#x27; &#x27;keyword optimization for app,&#x27; or &#x27;compare my app to competitors.&#x27; Use when the user shares an App Store or Google Play URL and wants to improve it.</p><h1>ASO Audit</h1>
<p>Analyze App Store and Google Play listings against ASO best practices. Fetches live listing data, scores metadata, visuals, and ratings, then produces a prioritized action plan.</p>
<h2>When to Use</h2>
<ul><li>User shares an App Store or Google Play URL</li><li>User asks to audit or optimize an app listing</li><li>User wants to compare their app against competitors</li><li>User asks about app store ranking, visibility, or download conversion</li></ul>
<h2>Before Auditing</h2>
<p><strong>Check for product marketing context first:</strong> If <code>.agents/product-marketing.md</code> exists (or <code>.claude/product-marketing.md</code>, or the legacy <code>product-marketing-context.md</code> filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.</p>
<h2>Phase 1 — Identify Store &amp; Fetch</h2>
<h3>Detect store type from URL</h3>
<pre><code>Apple: apps.apple.com/{country}/app/{name}/id{digits}
Google: play.google.com/store/apps/details?id={package}</code></pre>
<p>If the user gives an app name instead of a URL, search the web for: <code>site:apps.apple.com &quot;{app name}&quot;</code> or <code>site:play.google.com &quot;{app name}&quot;</code></p>
<h3>Fetch the listing</h3>
<p>Use WebFetch to retrieve the listing page. Extract every available field:</p>
<p><strong>Apple App Store fields:</strong></p>
<ul><li>App name (title) — 30 char limit</li><li>Subtitle — 30 char limit</li><li>Description (long) — not indexed for search, but matters for conversion</li><li>Promotional text — 170 chars, updatable without new release</li><li>Category (primary + secondary)</li><li>Screenshots (count, order, caption text)</li><li>Preview video (presence, duration)</li><li>Rating (average + count)</li><li>Recent reviews (visible ones)</li><li>Price / in-app purchases</li><li>Developer name</li><li>Last updated date</li><li>Version history notes</li><li>Age rating</li><li>Size</li><li>Languages / localizations listed</li><li>In-app events (if any visible)</li></ul>
<p><strong>Google Play fields:</strong></p>
<ul><li>App name (title) — 30 char limit</li><li>Short description — 80 char limit</li><li>Full description — 4,000 char limit, IS indexed for search</li><li>Category + tags</li><li>Feature graphic (presence)</li><li>Screenshots (count, order)</li><li>Preview video (presence)</li><li>Rating (average + count)</li><li>Recent reviews (visible ones)</li><li>Price / in-app purchases</li><li>Developer name</li><li>Last updated date</li><li>What&#x27;s new text</li><li>Downloads range</li><li>Content rating</li><li>Data safety section</li><li>Languages listed</li></ul>
<p>If WebFetch returns incomplete data (stores render client-side), note gaps and work with what&#x27;s available. Ask the user to paste missing fields if critical.</p>
<h3>Visual asset assessment</h3>
<p>WebFetch cannot extract screenshot images or caption text. <strong>Take a screenshot of the listing page</strong> to get visual data:</p>
<ol><li>Navigate to the listing URL and capture a full-page screenshot</li><li>Assess the screenshot for: icon quality, screenshot count, caption text,</li></ol>
<p> messaging quality, preview video presence, feature graphic (Google Play)</p>
<ol><li>If browser tools are unavailable, ask the user to share a screenshot of the</li></ol>
<p> listing page</p>
<p><strong>Promotional text (Apple):</strong> This 170-char field appears above the description but is often indistinguishable from it in scraped HTML. If you cannot confirm its presence, note this and recommend the user check App Store Connect.</p>
<hr>
<h2>Phase 1.5 — Assess Brand Maturity</h2>
<p>Before scoring, classify the app into one of three tiers. This determines how you interpret &quot;textbook ASO&quot; deviations — a deliberate brand choice by a household name is not the same as a missed opportunity by an unknown app.</p>
<h3>Tier definitions</h3>
<p>| Tier | Signals | Examples | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- | | <strong>Dominant</strong> | Household name, 1M+ ratings, top-10 in category, near-universal brand recognition. Users search by brand name, not generic keywords. | Instagram, Uber, Spotify, WhatsApp, Netflix | | <strong>Established</strong> | Well-known in their category, 100K+ ratings, strong organic installs, recognized brand but not universally known. | Strava, Notion, Duolingo, Cash App, Calm | | <strong>Challenger</strong> | Building awareness, &lt;100K ratings, needs discovery through keywords and ASO tactics. Most apps fall here. | Your app, most indie/startup apps |</p>
<h3>How tier affects scoring</h3>
<p><strong>Dominant apps</strong> get adjusted scoring in these areas:</p>
<ul><li><strong>Title:</strong> Brand-only or brand-first titles are valid (score 8+ if brand is the keyword). These apps don&#x27;t need generic keyword discovery.</li><li><strong>Description:</strong> Score purely on conversion quality, not keyword presence. If the app is a household name, a well-crafted brand description beats a keyword-stuffed one.</li><li><strong>Visual Assets:</strong> Lifestyle/brand photography instead of UI demos is a legitimate conversion strategy. No video is acceptable if the product is hard to demo in 30s or brand awareness is near-universal.</li><li><strong>What&#x27;s New:</strong> Generic release notes at weekly+ cadence are acceptable (score 8+). At scale, detailed changelogs have minimal ROI and risk backlash.</li><li><strong>In-app events:</strong> Missing events for utility apps with massive install bases (Uber, WhatsApp) is not a penalty. These apps don&#x27;t need discovery help.</li><li><strong>Localization:</strong> Score relative to actual market, not absolute count. A US-only fintech with 2 languages (English + Spanish) is appropriately localized.</li></ul>
<p><strong>Established apps</strong> get partial adjustment:</p>
<ul><li>Brand-first titles are fine but should still include 1-2 keywords</li><li>Strategic description choices get benefit of the doubt</li><li>Other dimensions scored normally</li></ul>
<p><strong>Challenger apps</strong> are scored strictly against textbook ASO best practices — every character, screenshot, and keyword matters.</p>
<p><strong>Key principle:</strong> Before docking points, ask: &quot;Is this a mistake or a deliberate choice by a team that has data I don&#x27;t?&quot; If the app has 1M+ ratings and a dedicated ASO team, assume their choices are data-informed unless clearly wrong.</p>
<hr>
<h2>Phase 2 — Score Each Dimension</h2>
<p>Score each dimension 0-10 using the criteria in <code>references/scoring-criteria.md</code>. Apply the brand maturity tier adjustments from Phase 1.5.</p>
<p>Reference files for platform specs and benchmarks:</p>
<ul><li><code>references/apple-specs.md</code> — Official Apple character limits, screenshot/video specs, CPP/PPO rules, rejection triggers</li><li><code>references/google-play-specs.md</code> — Official Google Play limits, screenshot specs, Android Vitals thresholds, policies</li><li><code>references/benchmarks.md</code> — Conversion data, rating impact, video lift, screenshot behavior, CPP/event benchmarks</li></ul>
<h3>Dimensions and Weights</h3>
<p>| # | Dimension | Weight | What It Covers | | --- | -------------------- | ------ | ------------------------------------------------------------------------- | | 1 | Title &amp; Subtitle | 20% | Character usage, keyword presence, clarity, brand + keyword balance | | 2 | Description | 15% | First 3 lines, keyword density (Google), CTA, structure, promotional text | | 3 | Visual Assets | 25% | Screenshot count/quality/messaging, video, icon, feature graphic | | 4 | Ratings &amp; Reviews | 20% | Average rating, volume, recency, developer responses | | 5 | Metadata &amp; Freshness | 10% | Category choice, update recency, localization count, data safety | | 6 | Conversion Signals | 10% | Price positioning, IAP transparency, social proof, download range |</p>
<p><strong>Final score</strong> = weighted sum, out of 100.</p>
<h3>Score interpretation</h3>
<p>| Score | Grade | Meaning | | ------ | ----- | --------------------------------------------------------- | | 85-100 | A | Well-optimized; focus on A/B testing and iteration | | 70-84 | B | Good foundation; clear opportunities to improve | | 50-69 | C | Significant gaps; prioritized fixes will have high impact | | 30-49 | D | Major optimization needed across multiple dimensions | | 0-29 | F | Listing needs a complete overhaul |</p>
<hr>
<h2>Phase 3 — Competitor Comparison (Optional)</h2>
<p>If the user provides competitor URLs or asks for comparison:</p>
<ol><li>Fetch 2-3 top competitors in the same category</li><li>Run the same scoring on each</li><li>Build a comparison table highlighting where the user&#x27;s app is weaker/stronger</li><li>Identify keyword gaps — terms competitors rank for that the user&#x27;s app doesn&#x27;t target</li></ol>
<p>If no competitors are specified, suggest the user provide 2-3 or offer to search for top apps in their category.</p>
<hr>
<h2>Phase 4 — Generate Report</h2>
<p>Use the template in <code>references/report-template.md</code> to structure the output.</p>
<p>The report must include:</p>
<ol><li><strong>Score card</strong> — table with all 6 dimensions, scores, and grade</li><li><strong>Top 3 quick wins</strong> — changes that take &lt;1 hour and have highest impact</li><li><strong>Detailed findings</strong> — per-dimension breakdown with specific issues and fixes</li><li><strong>Keyword suggestions</strong> — based on title/description analysis and competitor gaps</li><li><strong>Visual asset recommendations</strong> — specific screenshot/video improvements</li><li><strong>Priority action plan</strong> — ordered list of changes by impact vs effort</li></ol>
<h3>Report rules</h3>
<ul><li>Every recommendation must be <strong>specific and actionable</strong> (&quot;Change subtitle from X to Y&quot; not &quot;Improve subtitle&quot;)</li><li>Include character counts for all text recommendations</li><li>Flag platform-specific differences (Apple vs Google) when relevant</li><li>Note what CANNOT be assessed without paid tools (search volume, exact rankings)</li><li>When suggesting keyword changes, explain WHY each keyword matters</li></ul>
<hr>
<h2>Platform-Specific Rules</h2>
<h3>Apple App Store — Key Facts</h3>
<ul><li>Title (30 chars) + Subtitle (30 chars) + Keyword field (100 <strong>bytes</strong>, hidden) = indexed text</li><li>Keywords field is bytes not chars — Arabic/CJK use 2-3 bytes per char</li><li>Long description is NOT indexed for search — optimize for conversion only</li><li>Promotional text (170 chars) does NOT affect search (Apple confirmed)</li><li>Never repeat words across title/subtitle/keyword field (Apple indexes each word once)</li><li>Keyword field: commas, no spaces (&quot;photo,editor,filter&quot; not &quot;photo, editor, filter&quot;)</li><li>Screenshots: up to 10 per device. First 3 visible in search — 90% never scroll past 3rd</li><li>Screenshot captions indexed since June 2025 (AI extraction)</li><li>In-app events: max 10 published at once, max 31 days each. Indexed and appear in search</li><li>Custom Product Pages (up to 70) in organic search since July 2025. +5.9% avg conversion lift</li><li>App preview video: up to 3, 15-30s each. Autoplays muted — +20-40% conversion lift</li><li>SKStoreReviewController: max 3 prompts per 365 days</li><li>Apple has human editorial curation — quality and design matter more</li><li>See <code>references/apple-specs.md</code> for full specs, dimensions, and rejection triggers</li></ul>
<h3>Google Play — Key Facts</h3>
<ul><li>Title (30 chars) + Short description (80 chars) + Full description (4,000 chars) = indexed text</li><li>Full description IS indexed — target 2-3% keyword density naturally</li><li>No hidden keyword field — all keywords must be in visible text</li><li>Google NLP/semantic understanding — keyword stuffing detected and penalized</li><li>Prohibited in title: emojis, ALL CAPS, &quot;best&quot;/&quot;#1&quot;/&quot;free&quot;, CTAs (enforced since 2021)</li><li>Screenshots: min 2, <strong>max 8</strong> per device (not 10 like Apple)</li><li>Feature graphic (1024x500, exact) required for featured placements</li><li>Video does NOT autoplay — only ~6% of users tap play (low ROI vs iOS)</li><li>Android Vitals directly affect ranking: crash &gt;1.09% or ANR &gt;0.47% = reduced visibility</li><li>Promotional Content: submit 14 days early for featuring. Apps see 2x explore acquisitions</li><li>Custom Store Listings: up to 50 (can target churned users, specific countries, ad campaigns)</li><li>Store Listing Experiments: test up to 3 variants, run 7+ days, 1 experiment at a time</li><li>See <code>references/google-play-specs.md</code> for full specs and policy details</li></ul>
<h3>What Apple Indexes vs What Google Indexes</h3>
<p>| Field | Apple Indexed? | Google Indexed? | | --------------------- | ---------------- | ---------------------- | | Title | Yes | Yes (strongest signal) | | Subtitle / Short desc | Yes | Yes | | Keyword field | Yes (hidden) | Does not exist | | Long description | No | Yes (heavily) | | Screenshot captions | Yes (since 2025) | No | | In-app events | Yes | N/A (LiveOps instead) | | Developer name | No | Partial | | IAP names | Yes | Yes |</p>
<hr>
<h2>Common Issues Checklist</h2>
<p>Flag these if found. Items marked _(tier-dependent)_ should be evaluated against the app&#x27;s brand maturity tier — they may be deliberate choices for Dominant apps.</p>
<p><strong>Always flag (all tiers):</strong></p>
<ul><li>[ ] Rating below 4.0</li><li>[ ] Last update &gt; 3 months ago</li><li>[ ] Google Play description has no keyword strategy (under 1% density)</li><li>[ ] Google Play missing feature graphic</li><li>[ ] Apple keyword field likely has repeated words (inferred from title+subtitle)</li><li>[ ] Category mismatch — app would face less competition in a different category</li><li>[ ] Fewer than 5 screenshots</li></ul>
<p><strong>Flag for Challenger/Established only</strong> _(not mistakes for Dominant apps):_</p>
<ul><li>[ ] Title wastes characters on brand name only (no keywords) _(Dominant: brand IS the keyword)_</li><li>[ ] Subtitle/short description duplicates title keywords</li><li>[ ] Description first 3 lines are generic _(Dominant: may be brand-voice choice)_</li><li>[ ] No preview video _(Dominant: may be rational if product is hard to demo)_</li><li>[ ] Screenshots are just UI dumps with no messaging/captions _(Dominant: lifestyle/brand shots may convert better)_</li><li>[ ] Only 1-2 localizations _(score relative to actual market, not absolute count)_</li><li>[ ] No in-app events or promotional content _(Dominant utility apps may not need discovery help)_</li></ul>
<p><strong>Flag for all tiers but note context:</strong></p>
<ul><li>[ ] No developer responses to negative reviews _(note volume — responding at 10M+ reviews is a different challenge than at 1K)_</li><li>[ ] Generic &quot;What&#x27;s New&quot; text _(acceptable at weekly+ release cadence for Established/Dominant)_</li></ul>
<hr>
<h2>Task-Specific Questions</h2>
<ol><li>What is the App Store or Google Play URL?</li><li>Is this your app or a competitor&#x27;s?</li><li>What category does the app compete in?</li><li>Do you have competitor URLs to compare against?</li><li>Are you focused on search visibility, conversion rate, or both?</li><li>Do you have access to App Store Connect or Google Play Console data?</li></ol>
<hr>
<h2>Related Skills</h2>
<ul><li><strong>cro</strong>: For optimizing the conversion of web-based landing pages that drive app installs</li><li><strong>ad-creative</strong>: For creating App Store and Google Play ad creatives</li><li><strong>analytics</strong>: For setting up install attribution and in-app event tracking</li><li><strong>customer-research</strong>: For understanding user needs and language to inform listing copy</li></ul>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/aso.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>