App Store Optimization Guide

App Store Optimization Basics — Keywords, Screenshots & Ratings

by Gingiris-1031 · MIT license · ★ 82 on GitHub · updated Sep 20

Beginner-friendly App Store Optimization guide covering keyword research, screenshot design, rating management, and A/B testing for iOS and Android. By @WeiYipei — practical ASO for indie developers and small teams.

---
name: aso-playbook
description: |
  Beginner-friendly App Store Optimization guide covering keyword research, screenshot design, rating management, and A/B testing for iOS and Android. By @WeiYipei — practical ASO for indie developers and small teams.
source: https://github.com/Gingiris-1031/gingiris-skills/tree/main/skills/aso-playbook
tags:
  - aso
  - app-store-optimization
  - mobile-growth
  - keyword-research
  - app-marketing
  - app-store
  - ios
  - android
  - app-ranking
  - organic-growth
  - claude-code
  - ai-agent-skill

Overview

What you get after installing: - Keyword research methodology for finding low-competition, high-intent terms - Screenshot hypothesis and message-hierarchy framework - A/B testing and evidence-capture framework for iOS and Android

Manual install (npx, ZIP)

Claude Codenpx skills add Gingiris-1031/gingiris-skills --skill aso-playbook -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/Gingiris-1031/gingiris-skills/tar.gz/5d40bc8f4094 \
  | tar -xz -C ~/.claude/skills --strip-components=2 gingiris-skills-5d40bc8f4094/skills/aso-playbook

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/1e8fcafe847256079394/aso-playbook.zip" -OutFile "$env:TEMP\aso-playbook.zip"; Expand-Archive "$env:TEMP\aso-playbook.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md3.3 KB
_meta.json131 B
.clawhub/1 file · 144 B
references/3 files · 9.7 KB

Read the files here

Gingiris-1031/5d40bc86 files

SKILL.md

Show the full text77 lines

aso-playbook/SKILL.md77 lines · 3.3 KB

PreviewCode

Outline

RawView on GitHub

📦 Install

clawhub install aso-playbook

What you get after installing:

Keyword research methodology for finding low-competition, high-intent terms
Screenshot hypothesis and message-hierarchy framework
A/B testing and evidence-capture framework for iOS and Android

App Store Optimization Basics — Keywords, Screenshots & Ratings

🌍 Language / 语言: 中文 | English | 日本語 | 한국어

The fundamentals of ASO for developers who'd rather build than market — but need downloads.

Keyword research: Finding low-competition, high-intent keywords for your category
Screenshot optimization: Turn user intent into testable screenshot hypotheses
Rating strategy: How to ask for reviews without annoying users
Localization basics: Which markets to target first and how to test
A/B testing: What to test, how long to run, and interpreting results

Minimum viable ASO workflow

Export the last 28 days by country and traffic source: impressions, product-page views, first-time downloads, conversion rate, proceeds, D1/D7/D30 retention.
Build a keyword sheet with relevance, current rank, search popularity, competition, destination locale and target page.
Change one variable family at a time: metadata, icon, first three screenshots, preview video, rating prompt or localization.
Record the exact before/after version, release date, storefront and external UA activity.
Keep a test only when conversion improves without a material decline in retained users, rating quality or revenue.

Evidence gate

Do not claim an ASO win from downloads alone. A valid case needs, at minimum:

keyword rank or search-impression change;
impression → product-page-view rate;
product-page-view → first-time-download rate;
D7 or D30 retained-user outcome;
dates, storefronts, app version and paid-campaign overlap.

No controlled Gingiris App Store before/after dataset is bundled with this skill yet. The workflow is executable; any uplift claim must come from the user's own App Store Connect or Play Console export.

Compliance gate

Never recommend bought ratings/reviews, artificial searches or installs, device/account farms, chart manipulation, or packages intended to evade enforcement. Use official storefront experiments, authentic-user review prompts and transparent paid acquisition. Historical notes that mention black-hat tactics are research records, not execution guidance.

Full version: https://clawhub.ai/gingiris-1031/skills/gingiris-aso-growth
All skills: https://clawhub.ai/gingiris-1031
Follow: @WeiYipei on X

1	---
2	name: aso-playbook
3	description: \|
4	Beginner-friendly App Store Optimization guide covering keyword research, screenshot design, rating management, and A/B testing for iOS and Android. By @WeiYipei — practical ASO for indie developers and small teams.
5	source: https://github.com/Gingiris-1031/gingiris-skills/tree/main/skills/aso-playbook
6	tags:
7	- aso
8	- app-store-optimization
9	- mobile-growth
10	- keyword-research
11	- app-marketing
12	- app-store
13	- ios
14	- android
15	- app-ranking
16	- organic-growth
17	- claude-code
18	- ai-agent-skill
19	- indie-developer
20	- conversion-optimization
21	- latest
22	---
23
24	## 📦 Install
25
26	```bash
27	clawhub install aso-playbook
28	```
29
30	What you get after installing:
31	- Keyword research methodology for finding low-competition, high-intent terms
32	- Screenshot hypothesis and message-hierarchy framework
33	- A/B testing and evidence-capture framework for iOS and Android
34
35	---
36
37	# App Store Optimization Basics — Keywords, Screenshots & Ratings
38
39	> 🌍 Language / 语言: [中文](#中文版) \| [English](references/en/README.md) \| [日本語](references/ja/README.md) \| [한국어](references/ko/README.md)
40
41	The fundamentals of ASO for developers who'd rather build than market — but need downloads.
42
43	- Keyword research: Finding low-competition, high-intent keywords for your category
44	- Screenshot optimization: Turn user intent into testable screenshot hypotheses
45	- Rating strategy: How to ask for reviews without annoying users
46	- Localization basics: Which markets to target first and how to test
47	- A/B testing: What to test, how long to run, and interpreting results
48
49	## Minimum viable ASO workflow
50
51	1. Export the last 28 days by country and traffic source: impressions, product-page views, first-time downloads, conversion rate, proceeds, D1/D7/D30 retention.
52	2. Build a keyword sheet with relevance, current rank, search popularity, competition, destination locale and target page.
53	3. Change one variable family at a time: metadata, icon, first three screenshots, preview video, rating prompt or localization.
54	4. Record the exact before/after version, release date, storefront and external UA activity.
55	5. Keep a test only when conversion improves without a material decline in retained users, rating quality or revenue.
56
57	### Evidence gate
58
59	Do not claim an ASO win from downloads alone. A valid case needs, at minimum:
60
61	- keyword rank or search-impression change;
62	- impression → product-page-view rate;
63	- product-page-view → first-time-download rate;
64	- D7 or D30 retained-user outcome;
65	- dates, storefronts, app version and paid-campaign overlap.
66
67	No controlled Gingiris App Store before/after dataset is bundled with this skill yet. The workflow is executable; any uplift claim must come from the user's own App Store Connect or Play Console export.
68
69	### Compliance gate
70
71	Never recommend bought ratings/reviews, artificial searches or installs, device/account farms, chart manipulation, or packages intended to evade enforcement. Use official storefront experiments, authentic-user review prompts and transparent paid acquisition. Historical notes that mention black-hat tactics are research records, not execution guidance.
72
73	## Related Gingiris Skills
74	- Full version: https://clawhub.ai/gingiris-1031/skills/gingiris-aso-growth
75	- All skills: https://clawhub.ai/gingiris-1031
76	- Follow: [@WeiYipei on X](https://x.com/WeiYipei)
77