Metadata Optimization

Initial Assessment

1. Check for

   app-marketing-context.md

   — read it for positioning and target audience
2. Ask for the App ID (to see current metadata)
3. Ask for target keywords (or suggest running

   keyword-research

   first)
4. Ask for platform (iOS / Android / Both)
5. Ask for target country (default: US)

Platform-Specific Limits

Apple App Store (iOS)

Google Play (Android)

Optimization Framework

Title Optimization

• [Brand] - [Primary Keyword]

  (e.g., "Calm - Sleep & Meditation")

• [Brand]: [Benefit Phrase]

  (e.g., "Duolingo: Language Lessons")

• [Primary Keyword] [Brand]

  (e.g., "Headspace: Mindful Meditation")

• Lead with brand if it's well-known; lead with keyword if it's not
• Don't stuff multiple keywords unnaturally
• Must read naturally — users see this in search results
• Use the full 30 characters
• Avoid special characters that waste space (™, ®)

Subtitle Optimization (iOS)

• Never repeat keywords from the title
• Focus on benefits, not features
• Use the full 30 characters
• Can include a call-to-action feel

Keyword Field (iOS)

• Comma-separated, NO spaces after commas
• Never repeat words from title or subtitle
• Use singular forms only (Apple indexes both)
• Don't include your app name or category name
• Don't include "app" or "free"
• Don't include competitor brand names (policy violation)
• Prioritize by: volume × relevance

keyword1,keyword2,keyword3,keyword4,...
Characters used: [X]/100

Description (iOS — Conversion Focus)

1. Hook (first 3 lines) — This is all users see before "more". Make it count.
2. Social proof — Awards, press mentions, user count, rating
3. Key features — 4-6 bullet points with benefits, not just features
4. How it works — Simple 3-step explanation
5. Testimonial or review quote — Real user voice
6. CTA — Clear call to download

• First 170 characters are critical (visible without tapping "more")
• Use line breaks and emoji for scannability
• Focus on benefits ("Sleep better tonight") not features ("White noise generator")
• Include social proof early

Description (Android — SEO + Conversion)

• Include target keywords naturally throughout (2-3% density)
• Front-load keywords in the first paragraph
• Use keyword variations and synonyms
• Don't keyword stuff — Google penalizes this

Promotional Text (iOS)

• Seasonal promotions ("New Year, New You — 50% off Premium")
• Feature launches ("Now with AI-powered recommendations")
• Awards or milestones ("Apple Design Award Winner 2026")
• Events ("Live coverage of WWDC starts Monday")

Output Format

Metadata Package

1. Recommended version (primary recommendation)
2. Alternative A (different keyword emphasis)
3. Alternative B (different positioning angle)

• Character count:

  [X]/[limit]

• Keywords covered:

  [list]

• Rationale: Why this version works

Keyword Coverage Matrix

Before/After Comparison

Common Mistakes to Flag

• Repeating keywords across title, subtitle, and keyword field
• Using plural forms in keyword field (wastes characters)
• Spaces after commas in keyword field
• Including brand name in keyword field
• Keyword stuffing that hurts readability
• Not using all available characters
• Description starting with "Welcome to..." (weak hook)

Related Skills

• keyword-research

  — Run this first to identify target keywords

• aso-audit

  — Broader audit that includes metadata quality

• localization

  — Adapt metadata for international markets

• ab-test-store-listing

  — Test metadata variations

• competitor-analysis

  — See how competitors write their metadata