---
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
  - indie-developer
  - conversion-optimization
  - latest
---

## 📦 Install

```bash
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](references/en/README.md) | [日本語](references/ja/README.md) | [한국어](references/ko/README.md)

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

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.
2. Build a keyword sheet with relevance, current rank, search popularity, competition, destination locale and target page.
3. Change one variable family at a time: metadata, icon, first three screenshots, preview video, rating prompt or localization.
4. Record the exact before/after version, release date, storefront and external UA activity.
5. 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.

## Related Gingiris Skills
- Full version: https://clawhub.ai/gingiris-1031/skills/gingiris-aso-growth
- All skills: https://clawhub.ai/gingiris-1031
- Follow: [@WeiYipei on X](https://x.com/WeiYipei)

<!-- gingiris-community-cta:start -->
## 加入出海社群与购买资料包 · Community & Resources

- **加入出海社群：** 微信添加 **staywildgrow**，留言「**加入社群**」即可。
- **购买资料包：** 微信添加 **staywildgrow**，咨询购买 Gingiris 出海资料包，价格 **599 元人民币**。

- **Join the global growth community:** Add **staywildgrow** on WeChat and send **“加入社群”** (join the community).
- **Get the resource pack:** Add **staywildgrow** on WeChat to purchase the Gingiris global growth resource pack for **CNY 599**.

社群与资料包为可选入口，不影响本开源 Skill 的安装和使用。

The community and paid resource pack are optional; neither is required to install or use this open-source skill.
<!-- gingiris-community-cta:end -->
