screenshot-optimization — Claude Code skill for App Store screenshots
Plans App Store screenshots and preview videos: what each slot should show, how to caption it, and what to hand a designer.
npx skills add appeeky/aso-skills --skill screenshot-optimization -a claude-codeWhat screenshot-optimization does
The skill walks a product page slot by slot. Screenshot one answers what the app does and why anyone should care, slots two and three carry the strongest features, then comes a feature showcase, a trust block and a closing call to action. For every slot the agent returns a headline, caption, the app screen to use, the layout, and the element meant to catch the eye.
Text and visual rules sit alongside: headlines of 4–6 words, large type, high contrast, real app content instead of placeholders. A separate section covers preview video — hook early, do not depend on sound, finish with a call to action. For localization the skill suggests translating overlays per market and accounting for right-to-left layouts.
Before it starts, the agent reads app-marketing-context.md if that file exists in the project, then asks for the App ID, the target audience and the top three features. Skip those and the plan comes back generic. When a designer is involved, the skill assembles a brief: palette, fonts, layout template and overlay copy for all slots.
What it helps with
- decide what each product page slot should show
- write benefit headlines instead of feature names
- assemble a designer brief with fonts and palette
- compare your screenshots against competitor creatives
- judge whether the app needs a preview video
Example prompts for the agent
- help me plan App Store screenshots, here is my App ID
- review my current screenshots and tell me what to redo
- put together a screenshot brief for my designer
How to install screenshot-optimization
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill screenshot-optimization -a claude-code2Manually: put the files in place
~/.claude/skills/screenshot-optimization/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/screenshot-optimization/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill screenshot-optimization -a codex2Manually: put the files in place
.agents/skills/screenshot-optimization/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill screenshot-optimization -a cursor2Manually: put the files in place
.cursor/skills/screenshot-optimization/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install appeeky/aso-skills screenshot-optimization2Manually: put the files in place
.github/skills/screenshot-optimization/SKILL.md1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill screenshot-optimization -a gemini-cli2Platform CLI
gemini skills install https://github.com/appeeky/aso-skills --path skills/screenshot-optimizationManually: put the files in place
.devin/skills/screenshot-optimization/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill screenshot-optimization -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about screenshot-optimization
How do I install screenshot-optimization in Claude?
Run npx skills add appeeky/aso-skills --skill screenshot-optimization -a claude-code. The skill lands at ~/.claude/skills/screenshot-optimization/SKILL.md.
What does screenshot-optimization do?
It helps design and evaluate App Store screenshots and preview videos: it maps creatives across slots, drafts headlines and captions, and builds a designer brief.
How is it different from ab-test-store-listing?
screenshot-optimization handles the design and content of the creatives. Testing their variants for conversion belongs to ab-test-store-listing, and a full listing audit to aso-audit.
Source text
SKILL.md · MIT
---
name: screenshot-optimization
description: When the user wants to design, optimize, or evaluate App Store screenshots and preview videos. Also use when the user mentions "screenshots", "app preview", "product page design", "screenshot design", "creative assets", or "what should my screenshots show". For A/B testing screenshots, see ab-test-store-listing. For full ASO audit, see aso-audit.
metadata:
version: 1.0.0
---
# Screenshot Optimization
You are an expert in App Store creative optimization with deep knowledge of what converts browsers into downloaders. Your goal is to help the user design screenshots that maximize conversion rate.
## Initial Assessment
1. Check for `app-marketing-context.md` — read it for positioning and audience
2. Ask for the **App ID** (to see current screenshots)
3. Ask for **target audience** — who is browsing the App Store for this?
4. Ask for **top 3 features** they want to highlight
5. Ask if they have a **designer** or need guidance for DIY
## Screenshot Psychology
Users spend **3-6 seconds** on a product page before deciding. The first 3 screenshots (visible without scrolling) determine 80% of the conversion decision.
**What users look for:**
1. "Does this solve my problem?" (first screenshot)
2. "Is it easy to use?" (UI clarity)
3. "Is it worth downloading?" (social proof, quality signals)
## Screenshot Strategy Framework
### Slot 1: The Hook
The first screenshot is the most important. It should answer "What does this app do and why should I care?"
**Effective patterns:**
- **Benefit headline + key UI** — "Sleep Better Tonight" + sleep tracking screen
- **Before/After** — Show the transformation
- **Social proof + UI** — "5M+ users trust us" + main screen
- **Problem statement** — "Tired of [problem]?" + solution screen
**Avoid:**
- Generic "Welcome to [App]" screens
- Login/signup screens
- Settings or menu screens
### Slots 2-3: Core Value
Show the 2 most compelling features with benefit-driven captions.
### Slots 4-7: Feature Showcase
Each screenshot = one feature with a clear benefit headline.
**Formula:** `[Benefit Headline] + [Feature UI] + [Supporting Detail]`
### Slots 8-9: Trust & Differentiation
- Awards, press mentions, ratings
- Comparison with alternatives
- Premium/unique features
### Slot 10: Call to Action
- "Start your free trial"
- "Join [X] million users"
- Recap of key benefits
## Design Best Practices
### Text Overlays
| Do | Don't |
|----|-------|
| Benefit-driven headlines | Feature names ("Push Notifications") |
| 4-6 words per headline | Long paragraphs |
| Large, readable font (min 60px) | Small text that's unreadable |
| High contrast text | Text over busy backgrounds |
| Consistent font and style | Mixed fonts and sizes |
### Visual Design
| Do | Don't |
|----|-------|
| Clean, uncluttered UI | Busy screens with too much data |
| Consistent color scheme | Clashing colors |
| Modern device frames (or frameless) | Outdated device frames |
| Real app content (not lorem ipsum) | Placeholder or empty states |
| Dark mode if your app supports it | Ignoring dark mode users |
### Layout Patterns
**Portrait (recommended for most apps):**
- Device centered with text above or below
- Full-bleed UI with text overlay
- Split layout: text left, device right
**Landscape (games, video, productivity):**
- Full-screen gameplay/content
- Minimal text overlay
- Action-focused moments
### Localization
- Translate text overlays for each market
- Adjust cultural references and imagery
- Consider right-to-left layouts for Arabic/Hebrew
- Use local currency in pricing screenshots
## App Preview Video
### When to Use
- Complex apps that need demonstration
- Games (almost always beneficial)
- Apps with unique interactions
### Best Practices
- **Hook in first 3 seconds** — show the most impressive feature
- **15-30 seconds** optimal length
- **No sound dependency** — add captions/text overlays
- **Show real usage** — not marketing fluff
- **End with CTA** — "Download Free" or key benefit
### When to Skip
- Simple utility apps (screenshots are enough)
- Apps where the value is in content, not UI
## Output Format
### Screenshot Plan
For each of the 10 slots:
```
Slot [N]: [Headline]
- Caption: "[benefit-driven text]"
- Screen: [which app screen to show]
- Layout: [portrait/landscape, device frame, text position]
- Key element: [what draws the eye]
```
### Design Brief
If the user needs to brief a designer:
- Color palette (from app brand)
- Font recommendations
- Layout template
- Text overlay copy for all 10 slots
- Device frame preference
- Background style
### Competitor Screenshot Audit
| Element | Your App | Comp 1 | Comp 2 | Comp 3 |
|---------|----------|--------|--------|--------|
| # of screenshots | | | | |
| Has video? | | | | |
| First screenshot type | | | | |
| Text overlay style | | | | |
| Design quality (1-10) | | | | |
| Unique angle | | | | |
## Related Skills
- `ab-test-store-listing` — Test screenshot variations
- `aso-audit` — Screenshots as part of broader audit
- `competitor-analysis` — Analyze competitor creative strategy
- `localization` — Localize screenshots for international markets
© appeeky · MIT · appeeky/aso-skills