skills/mobile-app-dev/app-store-listing-optimizer/SKILL.md
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".
npx skillsauth add robertguss/claude-skills app-store-listing-optimizerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Craft high-converting, keyword-optimized App Store and Google Play listings through competitive research, strategic keyword selection, and data-driven screenshot planning.
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
Gather everything needed to position the app effectively. Ask the user:
Document the answers in a structured brief before proceeding.
Browse 8-12 competitor listings on the target store(s) using Chrome. For detailed methodology and search patterns, see references/keyword-research.md.
| 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 |
Narrow the master list to the highest-value keywords.
| 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 |
The 100-character keyword field has specific optimization rules:
Write optimized metadata for each target platform.
BrandName - Keyword Phrase or Keyword Phrase: BrandNameApply 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)
iOS (not searchable — optimize for conversion):
Google Play (searchable — balance keywords + conversion):
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}
Plan the visual sequence for maximum conversion. For detailed caption formulas, device specs, and sequence patterns, see references/screenshot-formulas.md.
| 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 |
Generate 2-3 alternatives for the highest-impact elements. Present all variants in a comparison table.
## 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 |
Present the final optimized listing as a structured document:
Save the complete listing document as ASO-{AppName}.md.
documentation
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.
testing
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.
documentation
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.
testing
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).