# App Store Optimization

Optimize App Store product pages for search visibility and conversion.

- Repository: https://github.com/dpearson2699/swift-ios-skills (1266 stars)
- Category: Testing
- License: see repository
- Last updated: 2026-07-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add dpearson2699/swift-ios-skills --skill app-store-optimization -g -a claude-code -y`
Codex: `npx skills add dpearson2699/swift-ios-skills --skill app-store-optimization -g -a codex -y`
Cursor: `npx skills add dpearson2699/swift-ios-skills --skill app-store-optimization -g -a cursor -y`
Gemini CLI: `npx skills add dpearson2699/swift-ios-skills --skill app-store-optimization -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add dpearson2699/swift-ios-skills`

## Description

Optimize App Store product pages for search visibility and conversion. Use for App Store Optimization (ASO), keyword research, app name/subtitle/keyword-field strategy, conversion-focused descriptions and promotional text, screenshot captions and ordering, Custom Product Pages with assigned search keywords, In-App Events, Product Page Optimization tests, localized metadata, ratings/review strategy, and in-app review prompt timing with RequestReviewAction or AppStore.requestReview. Also use when routing ASO vs App Store review, privacy/ATT, or StoreKit implementation boundaries.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# App Store Optimization (ASO)

Search visibility and conversion optimization for App Store product pages. This skill covers strategic metadata decisions -- which keywords to target, how to structure descriptions for conversion, and how to use Custom Product Pages and in-app events for discoverability. For metadata compliance rules (character limits, screenshot device requirements, rejection triggers), see the `app-store-review` skill.

## Contents

- [Workflow and Boundaries](#workflow-and-boundaries)
- [Title and Subtitle Strategy](#title-and-subtitle-strategy)
- [Keyword Field Strategy](#keyword-field-strategy)
- [Description Structure](#description-structure)
- [Promotional Text](#promotional-text)
- [Screenshot and Preview Optimization](#screenshot-and-preview-optimization)
- [In-App Review Prompts](#in-app-review-prompts)
- [Custom Product Pages](#custom-product-pages)
- [In-App Events](#in-app-events)
- [Product Page Optimization](#product-page-optimization)
- [Ratings and Review Management](#ratings-and-review-management)
- [Localized Metadata Optimization](#localized-metadata-optimization)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)

## Workflow and Boundaries

1. Split recommendations into **Visibility** (indexed metadata, localization,
   ratings, events) and **Conversion** (message, assets, variants, experiments).
2. Name the evidence, owner, target metric, and validation checkpoint for each.
3. Apply the [Review Checklist](#review-checklist).

| Work | Owner |
|---|---|
| Listing, keyword/message fit, assets, page variants, localization, events, ratings strategy | This skill |
| Submission compliance, privacy manifest/labels, ATT wording, rejection risk | `app-store-review` |
| Purchases, paywalls, entitlements, subscription mechanics | `storekit` |

## Title and Subtitle Strategy

The rest: https://github.com/dpearson2699/swift-ios-skills/blob/HEAD/skills/app-store-optimization/SKILL.md