Communitygithub.com

rshankras/claude-code-apple-skills

Generates A/B test plans and optimization checklists for your App Store product page — icon, screenshots, and app previews. Use when running Product Page Optimization tests or improving conversion rates.

Qu'est-ce que claude-code-apple-skills ?

claude-code-apple-skills is a Claude Code agent skill that generates A/B test plans and optimization checklists for your App Store product page — icon, screenshots, and app previews. Use when running Product Page Optimization tests or improving conversion rates.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rshankras/claude-code-apple-skills/tree/HEAD/skills/generators/product-page-optimization

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Product Page Optimization Generator

Create structured A/B test plans for App Store Product Page Optimization (PPO), including test hypotheses, variant designs, success metrics, and iteration strategy.

When This Skill Activates

Use this skill when the user:

  • Asks to "optimize product page" or "A/B test App Store page"
  • Mentions "product page optimization" or "PPO"
  • Wants to improve "App Store conversion rate"
  • Asks about "screenshot testing" or "icon testing"
  • Mentions improving download rate or tap-through rate

How PPO Works

  • Test up to 3 treatments against your original (control); a single test can include up to 3 app preview videos per treatment
  • Testable elements: app icon, screenshots, app previews
  • Traffic proportion: you choose 1–50% of page traffic, split evenly across treatments (30% over 3 treatments = 10% each) — no treatment may exceed the original page's share
  • Duration: run at least 1 week and extend in 7-day increments to capture weekday/weekend cycles; hard cap 90 days
  • Statistical confidence: no confidence shown for the first 7 days; 90% confidence is the decision bar — per Apple, "9 of 10 reruns would repeat the result"
  • Localization: tests can target specific localizations only — confirm those locales have enough traffic to conclude within 90 days
  • Icon treatments: can only use icons that already ship in the app binary's asset catalog as alternate icons — plan icon tests one release ahead
  • Prerequisites: app must be Ready for Sale; role must be Account Holder, Admin, App Manager, or Marketing

Important Limitations

  • Cannot test: app name, subtitle, description, keyword field, or price
  • One test at a time per localization
  • Only one test submission can be in App Review at a time
  • Results apply to organic App Store traffic only
  • Minimum traffic required for statistical significance

Minimum Traffic Thresholds

PPO requires sufficient impression volume to produce meaningful results. If the app doesn't meet these thresholds, skip A/B testing and make direct qualitative improvements instead.

Monthly ImpressionsCan You PPO?Recommendation
Under 1,000NoDon't bother — tests will never reach significance. Apply screenshot best practices directly.
1,000-5,000BarelyTest ONE element at a time with only 1 variant (A/B, not A/B/C). Expect 4-8 week test cycles.
5,000-20,000YesStandard testing. Run 2 variants per test, 2-4 week cycles.
20,000+AggressivelyTest 3 variants, rapid iteration. Can test icon + screenshots sequentially.

If below threshold: Focus on qualitative improvements (follow the Quick Win Checklist in the output) rather than running inconclusive A/B tests.

Test Discipline (per Apple's Tech Talk)

  • ✅ Estimate before you start: use App Store Connect's Estimate Your Test Duration tool — example: detecting a 5% improvement at 50% traffic needs ~174k impressions ≈ 2 weeks
  • ✅ Make treatments NOTABLY different — subtle tweaks (small color shifts, reordered captions) typically end inconclusive
  • ✅ Have next-test assets ready before each release window — icon candidates must ship in the binary, so an unprepared release stalls the pipeline a full cycle
  • ✅ A winning control is still learning — you've validated the existing page and eliminated a hypothesis
  • ❌ Don't stop a test early because a treatment "looks ahead" — confidence isn't even shown for the first 7 days
  • ❌ Don't port A/B winners from other platforms or ad networks — App Store audiences convert differently

Applying Winners

Winning elementHow it ships
Screenshots / app previews"Apply Treatment to Original Product Page" in App Store Connect — no new binary or review
App iconShip it as the default icon in the next app binary

Real Results (Apple-cited)

AppTestResult
PeakIcon variants+8% conversion at 98% confidence (44 days, 154K impressions per treatment)
Angry Birds 2Seasonal art vs. controlControl won (+1.5%, 100% confidence) — validated existing creative
Simply PianoScreenshots-only vs. app previewScreenshots-only won, +3.3% in 12 days

Configuration Questions

Ask user via AskUserQuestion:

  1. What do you want to test?

    • App icon variants
    • Screenshot order/design
    • App preview video
    • Multiple elements (run sequentially)
  2. What's your current conversion rate concern?

    • Low impression-to-page-view rate (need better icon/name)
    • Low page-view-to-download rate (need better screenshots/description)
    • Low overall conversion (need comprehensive optimization)
    • Don't know (need baseline measurement)
  3. Monthly impression volume?

    • Under 1,000 (PPO may not reach significance — focus on qualitative improvements)
    • 1,000-10,000 (test one element at a time, longer test duration)
    • 10,000-100,000 (can test 2-3 variants, standard duration)
    • 100,000+ (can test aggressively, quick results)

Generation Process

Step 1: Audit Current Page

Review the existing product page:

  • Current screenshot sequence and messaging
  • Icon design and distinctiveness
  • App preview presence and quality
  • Promotional text and description

Step 2: Generate Test Plan

Produce a structured test plan with:

  • Hypothesis for each test
  • Variant descriptions
  • Expected impact
  • Duration and traffic requirements

Step 3: Design Variant Specs

For each variant, specify:

  • What changes from control
  • Design direction and mockup description
  • Why this variant might outperform

Output Format

# Product Page Optimization Plan: [App Name]

## Current State Assessment

| Element | Current | Strength | Weakness |
|---------|---------|----------|----------|
| Icon | [Description] | [What works] | [What doesn't] |
| Screenshots | [Description] | [What works] | [What doesn't] |
| Preview | [Present/Absent] | [What works] | [What doesn't] |
| Promo Text | [Description] | [What works] | [What doesn't] |

**Estimated current conversion rate**: [X%] (category average: [Y%])

---

## Test 1: [Element Being Tested]

### Hypothesis
"If we [change], then [metric] will improve because [rationale]."

### Variants

| Variant | Description | Key Difference from Control |
|---------|-------------|---------------------------|
| Control (A) | [Current design] | — |
| Treatment B | [Description] | [What's different] |
| Treatment C | [Description] | [What's different] |

### Test Configuration
- **Element**: [Icon / Screenshots / Preview]
- **Localization**: [All / Specific locale]
- **Duration**: [14-28 days]
- **Traffic requirement**: [~X impressions per variant]
- **Success metric**: [Conversion rate improvement > X%]

### Design Specs per Variant
[Detailed specs for each variant]

---

## Test 2: [Next Element]
[Same format — run after Test 1 concludes]

---

## Testing Roadmap

| Order | Test | Element | Duration | Expected Lift |
|-------|------|---------|----------|--------------|
| 1 | [Name] | [Element] | [Weeks] | [%] |
| 2 | [Name] | [Element] | [Weeks] | [%] |
| 3 | [Name] | [Element] | [Weeks] | [%] |

## Quick Win Checklist

While waiting for PPO results, implement these proven improvements:
- [ ] First screenshot shows core value in under 2 seconds
- [ ] Screenshots use benefit-focused captions (not feature names)
- [ ] App preview starts with the "wow moment" in first 3 seconds
- [ ] Icon is distinct and recognizable at small sizes
- [ ] Promotional text includes a current hook or seasonal relevance

Common Test Ideas

Icon Tests

TestControlVariantExpected Impact
ColorCurrent colorContrasting colorHigher tap-through from search
Style3D/detailedFlat/minimalModernized perception
ElementFull logoKey symbol onlyBetter small-size recognition
BackgroundSolidGradientShelf standout

Plan one release ahead: add candidate icons to the asset catalog as alternate app icons in THIS release so you can PPO-test them in the NEXT one. Shipping them costs nothing — users never see unused alternates.

Screenshot Tests

TestControlVariantExpected Impact
First screenshotFeature-focusedBenefit-focusedHigher engagement
LayoutDevice framesFull-bleedMore immersive
TextFeature namesUser outcomesStronger conversion
OrderStandard flowProblem→SolutionBetter storytelling
Social proofNoneReviews/awardsTrust building

App Preview Tests

TestControlVariantExpected Impact
HookSlow introImmediate actionHigher watch-through
Length30 seconds15 secondsLess drop-off
StyleScreen recordingLifestyle + UIEmotional connection

Seasonal Optimization Calendar

SeasonFocusScreenshot Refresh
JanNew Year energy, fresh startsResolution-themed captions
Mar-AprSpring cleaning, organizationProductivity-focused
JunWWDC, new OS features"Updated for iOS [X]"
Aug-SepBack to schoolStudent/education focus
Nov-DecHoliday, gift-givingGift-worthy messaging

References

  • Related: generators/custom-product-pages — Targeted pages per audience
  • Related: app-store/screenshot-planner — Screenshot design guidance
  • Related: app-store/keyword-optimizer — Text optimization
  • Related: app-store/marketing-strategy — Overall optimization strategy

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés