app-store-listing-optimizer

Optimize iOS App Store and Google Play Store listings for maximum discoverability and conversion. Perform competitive keyword research, craft keyword-optimized titles/subtitles/descriptions, design screenshot sequences, and generate A/B test variants. Use when the user has a built app and needs to write or improve their store listing, do ASO keyword research, optimize app metadata, plan screenshot strategy, or create listing variants for testing. Triggers on "optimize my app listing", "ASO", "app store optimization", "keyword research for my app", "improve my store listing", "screenshot strategy", "app store keywords", "play store listing".

56 stars

Best use case

app-store-listing-optimizer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Optimize iOS App Store and Google Play Store listings for maximum discoverability and conversion. Perform competitive keyword research, craft keyword-optimized titles/subtitles/descriptions, design screenshot sequences, and generate A/B test variants. Use when the user has a built app and needs to write or improve their store listing, do ASO keyword research, optimize app metadata, plan screenshot strategy, or create listing variants for testing. Triggers on "optimize my app listing", "ASO", "app store optimization", "keyword research for my app", "improve my store listing", "screenshot strategy", "app store keywords", "play store listing".

Teams using app-store-listing-optimizer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/app-store-listing-optimizer/SKILL.md --create-dirs "https://raw.githubusercontent.com/robertguss/claude-code-toolkit/main/skills/mobile-app-dev/app-store-listing-optimizer/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/app-store-listing-optimizer/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How app-store-listing-optimizer Compares

Feature / Agentapp-store-listing-optimizerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Optimize iOS App Store and Google Play Store listings for maximum discoverability and conversion. Perform competitive keyword research, craft keyword-optimized titles/subtitles/descriptions, design screenshot sequences, and generate A/B test variants. Use when the user has a built app and needs to write or improve their store listing, do ASO keyword research, optimize app metadata, plan screenshot strategy, or create listing variants for testing. Triggers on "optimize my app listing", "ASO", "app store optimization", "keyword research for my app", "improve my store listing", "screenshot strategy", "app store keywords", "play store listing".

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# App Store Listing Optimizer

Craft high-converting, keyword-optimized App Store and Google Play listings
through competitive research, strategic keyword selection, and data-driven
screenshot planning.

## Prerequisites

- **Chrome browser** with Claude in Chrome extension (for browsing competitor
  listings)
- No API keys required — all research uses live store browsing
- Supports **iOS App Store**, **Google Play Store**, or **both**

## Workflow Overview

```
1. App Analysis        — Understand the app, audience, differentiators
2. Competitive Research — Browse competitor listings, extract keywords
3. Keyword Selection    — Identify high-intent, low-competition keywords
4. Craft the Listing    — Write optimized metadata for each platform
5. Screenshot Strategy  — Plan visual sequence and caption copy
6. A/B Test Variants    — Generate 2-3 alternatives for split testing
```

---

## Step 1: Analyze the App

Gather everything needed to position the app effectively. Ask the user:

1. **What does the app do?** One sentence, plain language.
2. **Target platform?** iOS, Android, or both?
3. **Who is it for?** Primary audience, age range, expertise level.
4. **Top 3 features** — What does it do better or differently?
5. **Differentiator** — Why pick this over competitors?
6. **Monetization** — Free, freemium, subscription, one-time purchase?
7. **Current listing** (if updating) — Share the existing store URL.

Document the answers in a structured brief before proceeding.

---

## Step 2: Competitive Keyword Research

Browse 8-12 competitor listings on the target store(s) using Chrome. For
detailed methodology and search patterns, see
[references/keyword-research.md](references/keyword-research.md).

### What to Extract Per Competitor

| Field            | Where to Find                             |
| ---------------- | ----------------------------------------- |
| App name         | Title on store listing                    |
| Subtitle / short | Below title (iOS) or short desc (Android) |
| Full description | Store listing body                        |
| Rating + count   | Store listing header                      |
| Category rank    | Store listing or chart position           |
| Screenshots      | Visual carousel — note caption text       |

### Keyword Extraction Process

1. **List every keyword and phrase** from competitor titles and subtitles.
2. **Scan descriptions** for repeated terms — these are intentional keyword
   targets.
3. **Note caption text** on competitor screenshots — often contains keyword
   variations.
4. **Build a master keyword list** of 40-60 candidate terms.

### Platform Differences

- **iOS:** Only the app name, subtitle, and keyword field are indexed for
  search. The description is NOT searchable — it exists purely for conversion.
- **Google Play:** The full description IS indexed. Keyword density matters, but
  avoid stuffing. The short description carries extra weight.

---

## Step 3: Keyword Selection

Narrow the master list to the highest-value keywords.

### Selection Criteria

| Factor          | What to Look For                                              |
| --------------- | ------------------------------------------------------------- |
| **Relevance**   | Directly describes what the app does or solves                |
| **Intent**      | User searching this term wants what the app offers            |
| **Competition** | Fewer top-rated apps ranking for this term = better chance    |
| **Volume**      | Term appears across multiple competitor listings              |
| **Length**      | Longer phrases (2-3 words) = lower competition, higher intent |

### Prioritization Tiers

- **Tier 1 (must use):** High relevance + clear intent + moderate competition.
  Place in title or subtitle.
- **Tier 2 (strong):** Good relevance + decent volume. Place in iOS keyword
  field or Google Play description.
- **Tier 3 (supplemental):** Related terms, synonyms, adjacent use cases. Fill
  remaining keyword space.

### iOS Keyword Field Rules

The 100-character keyword field has specific optimization rules:

- Comma-separated, **no spaces after commas** (wastes characters)
- Do NOT repeat words already in the app name or subtitle
- Do NOT include the word "app" (Apple adds it automatically)
- Do NOT include plurals if the singular is present (Apple handles this)
- Do NOT include common prepositions or articles
- Use singular forms only
- Include competitor brand misspellings only if ethical and relevant

### Google Play Keyword Strategy

- No keyword field exists — optimize within the description text
- Repeat primary keywords 3-5 times naturally across the full description
- Place highest-priority keywords in the first paragraph and short description
- Use keyword variations and synonyms throughout
- Avoid keyword stuffing — Google penalizes unnatural density

---

## Step 4: Craft the Listing

Write optimized metadata for each target platform.

### App Name (both platforms: 30 characters max)

- Include the primary keyword naturally
- Lead with the brand name if it has recognition; otherwise lead with the
  keyword
- Format options: `BrandName - Keyword Phrase` or `Keyword Phrase: BrandName`
- Test readability — truncation happens around 20-25 chars in search results

### iOS Subtitle (30 characters max)

- Reinforce the value proposition with secondary keywords
- Do NOT repeat words from the app name
- Focus on benefit, not feature: "Sleep Better Tonight" > "Sleep Tracker App"
- Every character counts — use the full 30

### Google Play Short Description (80 characters max)

- Searchable and prominently displayed — treat as a headline + subtitle combined
- Include 1-2 primary keywords
- Communicate the core value proposition
- More space than iOS subtitle — use it to differentiate

### iOS Keyword Field (100 characters max)

Apply the rules from Step 3. Present the final keyword string with character
count. Example format:

```
sleep,tracker,insomnia,white,noise,meditation,relax,bedtime,routine,calm
(87/100 characters)
```

### Full Description

**iOS (not searchable — optimize for conversion):**

- First 3 lines appear before "Read More" — hook immediately
- Lead with the strongest benefit statement
- Use short paragraphs and line breaks for scannability
- Include social proof (awards, press, user count) early
- End with a clear call to action
- Unicode symbols (checkmarks, stars) draw the eye in bullet lists

**Google Play (searchable — balance keywords + conversion):**

- First 3 lines appear before "Read More" — same hook principle
- Weave primary keywords into the first paragraph naturally
- Use keyword variations throughout (don't repeat the exact same phrase)
- Structure: Hook > Features > Social proof > CTA
- 4,000 character max — use 3,000-3,500 for optimal density
- Include a "What's New" narrative for returning visitors

### First 3 Lines Template

These lines appear in search results before the user taps "Read More." They must
accomplish three things: (1) state the core benefit, (2) differentiate from
competitors, (3) compel the tap.

```
{Primary benefit statement — what the user gets}
{Differentiator — why this app, not the others}
{Social proof or specificity — numbers, awards, or unique method}
```

---

## Step 5: Screenshot Strategy

Plan the visual sequence for maximum conversion. For detailed caption formulas,
device specs, and sequence patterns, see
[references/screenshot-formulas.md](references/screenshot-formulas.md).

### Key Principles

- **First 3 screenshots** appear in search results — they must tell the story
  alone
- **Screenshot 1** is the most important asset in your entire listing
- Show the app in action, not splash screens or logos
- Every screenshot needs a caption — text above or below the device frame
- Social proof screenshots (ratings, user count) measurably increase conversion
- App preview videos autoplay in iOS search results — consider one if the app
  has visual appeal

### Recommended Sequence (5-10 screenshots)

| Position | Purpose                | Caption Focus                     |
| -------- | ---------------------- | --------------------------------- |
| 1        | Hero / primary benefit | Strongest value proposition       |
| 2        | Key feature #1         | Most differentiating feature      |
| 3        | Key feature #2         | Second strongest feature          |
| 4        | Social proof           | Ratings, user count, press quote  |
| 5        | Feature #3             | Unique capability                 |
| 6        | Customization / UI     | Show personalization options      |
| 7        | Before/after or result | Outcome the user achieves         |
| 8        | Pricing / value        | What they get for the price       |
| 9-10     | Additional features    | Remaining noteworthy capabilities |

### Platform-Specific Limits

- **iOS:** Up to 10 screenshots per device type. First 3 shown in search.
- **Google Play:** Up to 8 screenshots per device type. First 3-4 shown in
  search. Feature graphic (1024x500) is required and prominently displayed.

---

## Step 6: A/B Test Variants

Generate 2-3 alternatives for the highest-impact elements. Present all variants
in a comparison table.

### What to Test (in priority order)

1. **App subtitle / short description** — Highest impact on conversion from
   search results
2. **First 3 description lines** — Controls "Read More" tap-through rate
3. **Screenshot 1 caption** — First visual impression
4. **App name keyword** — Only test if willing to change the indexed name

### Variant Generation Rules

- Each variant should test ONE hypothesis (benefit-led vs feature-led, emotional
  vs rational, specific vs broad)
- Keep variants meaningfully different — changing one word is not a real test
- Label variants clearly: Variant A (control), Variant B, Variant C
- Note the hypothesis each variant tests

### Output Format

```markdown
## A/B Test Plan

### Subtitle Variants (iOS)

| Variant | Text                 | Hypothesis           | Chars |
| ------- | -------------------- | -------------------- | ----- |
| A       | {current or default} | Benefit-focused      | XX/30 |
| B       | {alternative}        | Feature-focused      | XX/30 |
| C       | {alternative}        | Social-proof-focused | XX/30 |

### First 3 Lines Variants

| Variant | Lines          | Hypothesis       |
| ------- | -------------- | ---------------- |
| A       | {3-line block} | Emotional hook   |
| B       | {3-line block} | Data-driven hook |

### Screenshot 1 Caption Variants

| Variant | Caption   | Hypothesis      |
| ------- | --------- | --------------- |
| A       | {caption} | Problem-focused |
| B       | {caption} | Outcome-focused |
```

---

## Localization Notes

- Localizing the listing into 5-10 languages multiplies keyword reach
  significantly — each locale has its own keyword index
- Prioritize: Spanish, French, German, Japanese, Korean, Portuguese, Chinese
  (Simplified)
- At minimum, localize the app name, subtitle, keywords, and first 3 description
  lines
- Google Play auto-translates listings but manual localization always
  outperforms
- Each locale can target entirely different keywords for the same app

---

## Deliverables Checklist

Present the final optimized listing as a structured document:

- [ ] App name (with character count)
- [ ] iOS subtitle (with character count)
- [ ] Google Play short description (with character count)
- [ ] iOS keyword field (with character count)
- [ ] Full description — iOS version
- [ ] Full description — Google Play version (keyword-optimized)
- [ ] Screenshot sequence plan with captions (5-10 screenshots)
- [ ] A/B test variants table (2-3 per element)
- [ ] Localization priority list (if applicable)

Save the complete listing document as `ASO-{AppName}.md`.

Related Skills

paywall-pricing-optimizer

56
from robertguss/claude-code-toolkit

Design effective paywalls, structure subscription tiers, and optimize pricing for mobile apps. Covers monetization model selection, paywall screen design, pricing psychology, A/B testing strategy, and RevenueCat/StoreKit/Google Billing integration. Use when the user wants to monetize an app, design a paywall, choose between subscription vs one-time purchase, set pricing tiers, improve conversion rates, plan pricing experiments, or integrate in-app purchases. Triggers on "design my paywall", "how should I price my app", "subscription tiers", "monetization strategy", "paywall copy", "free trial length", "RevenueCat setup", "improve paywall conversion".

app-store-opportunity-research

56
from robertguss/claude-code-toolkit

Full-pipeline iOS App Store opportunity research. Discovers underserved niches, analyzes competitor gaps, estimates revenue, produces scored top-3 opportunity reports, and writes MVP PRDs — all through browser and web research. Use when the user wants to find profitable iOS app ideas, research App Store charts, analyze competitor apps (ratings, reviews, revenue, gaps), generate opportunity reports, or write MVP PRDs. Triggers on "find app opportunities", "app store research", "what app should I build", "research this app category", "find a gap in the app store", "ios app ideas".

writing-dna-discovery

56
from robertguss/claude-code-toolkit

Capture a writer's voice DNA through collaborative interview and sample analysis. Use when someone wants to document their writing voice for use with a ghost writer skill. Produces a Voice DNA Document with patterns, anti-patterns, and actionable guidance. Handles one register/mode per session, supports refinement over time.

ghost-writer

56
from robertguss/claude-code-toolkit

Produce first drafts that match a writer's authentic voice using their Voice DNA Document. Consumes DNA documents from writing-dna-discovery skill. Generates 2 meaningfully different drafts with headlines, confidence assessment, decision notes, and DNA refinement suggestions. Collaborative partner that evaluates, pushes back, and advocates for quality. Handles blog posts, essays, newsletters, and more.

chapter-architect

56
from robertguss/claude-code-toolkit

Plan and architect a single chapter at beat-level granularity. Use when you have a chapter from the Architecture Document and need to create a detailed outline before drafting. Produces a Chapter Outline Document for use by draft-coach or ghostwriter.

book-research-assistant

56
from robertguss/claude-code-toolkit

Plan, orchestrate, and validate deep research for nonfiction books. Use when an author has completed book architecture and needs to fill research gaps before outlining chapters. Triggers include requests to plan research, generate research prompts, validate research quality, or prepare for drafting. This skill does everything around deep research—planning, prompting, validating, synthesizing—but the actual research execution happens externally via Claude and Gemini deep research. Requires upstream documents from book-architect (Research Gaps Document, Master Architecture Document, Section Blueprints) and book-ideation (Book Concept Document).

book-market-research

56
from robertguss/claude-code-toolkit

Assess commercial viability of book concepts for Amazon KDP self-publishing. Use when the user has a Book Concept Document and wants to understand market demand, competition, pricing, and positioning before committing to write. Produces a Market Research Report with viability scorecard and Go/No-Go recommendation. Works standalone (commercial analysis only) or after idea-validator (integrated assessment). Nonfiction only.

book-ideation

56
from robertguss/claude-code-toolkit

Develop raw book ideas into structured nonfiction book concepts. Use when the user wants to develop a book idea, has brainstorm documents to refine into a book concept, wants to articulate a book's thesis/promise/reader/transformation, or needs to prepare a book concept for validation and market research. Nonfiction only. Produces a Book Concept Document with all elements needed for downstream skills (idea-validator, market-research, book-architect).

book-idea-validator

56
from robertguss/claude-code-toolkit

Stress-test book concepts against existing research before committing to architecture. Use when the user has a Book Concept Document ready for validation, wants to verify their thesis is defensible, needs to understand the competitive intellectual landscape, or wants honest assessment of their idea's strengths and weaknesses. Produces a Validation Report that informs the Go/No-Go decision. Nonfiction only.

book-architect

56
from robertguss/claude-code-toolkit

Design the structural and emotional architecture for nonfiction books. Use when an author has a validated book concept and needs to create the blueprint before drafting. Triggers include requests to structure a book, create a chapter outline, design a table of contents, map the reader's journey, or plan book organization. Requires upstream documents from book-ideation (Book Concept Document) and optionally from idea-validator (Validation Report) and market-research (Market Research Report).

mobile-app-launch-checklist

56
from robertguss/claude-code-toolkit

Comprehensive step-by-step launch checklist for shipping mobile apps to the iOS App Store and Google Play Store. Covers pre-submission preparation, store asset creation, build and submission, launch day execution, and post-launch monitoring. Use when the user wants to launch a mobile app, prepare for App Store or Google Play submission, create a launch plan, review submission requirements, or ensure nothing is missed before releasing an app. Triggers on "launch checklist", "app submission", "prepare for launch", "app store submission", "google play submission", "ready to ship", "pre-launch review", "launch day plan".

simple-tasks

56
from robertguss/claude-code-toolkit

Install a fast local task workflow for single-project planning with `scripts/task.sh` (claim, done, status, reporting) backed by `tasks/TASKS.md` and optional `tasks/details/` notes. Use for lightweight in-progress task coordination, not full team issue tracking.