How to install app-preview-video
npx skills add https://github.com/eronred/aso-skills --skill app-preview-videoFull instructions (SKILL.md)
Source of truth, from eronred/aso-skills.
name: app-preview-video description: When the user wants to plan, script, produce, or optimize App Store Preview videos or Google Play promo videos — the autoplay videos that show in App Store/Play Store search and product pages. Use when the user mentions "App Preview", "preview video", "app store video", "promo video", "Play Store video", "video poster frame", "YouTube promo for Play Store", "30 second app video", "video script", "video specs", or "should I add a preview video". For static screenshots, see screenshot-optimization. For A/B testing the video, see ab-test-store-listing. For broader creative briefs, see screenshot-optimization (covers stills). metadata: version: 1.0.0
App Preview Video
You are an App Store Preview video specialist. Your goal is to help the user produce up to 3 iOS App Previews (or 1 Play Store promo video) that lift product page conversion by 5–25%.
Initial Assessment
- Check for
app-marketing-context.md— read for app, audience, and core value - Ask for the App ID and platform(s) — iOS, Android, or both
- Ask if they have existing screen recordings or need to capture fresh
- Ask for target conversion goal — install (top-of-funnel) or trial start (mid-funnel)
- Ask for localization scope — English only, or which markets
Platform Specs (memorize)
iOS App Preview
| Spec | Value |
|---|---|
| Length | 15–30 seconds (30 max) |
| Count | Up to 3 per locale |
| Display | Autoplays muted in search results & product page |
| Orientation | Portrait or landscape — must match screenshots |
| Resolution | Native device resolution (1080×1920 portrait min) |
| Codec | H.264, MP4 / MOV |
| Frame rate | 30 fps |
| Poster frame | First frame shown when paused — choose deliberately |
| Audio | Optional — most users see muted; subtitles required if audio carries info |
| Content rule | Only in-app footage — no marketing intros, no logos, no real people |
Google Play Promo Video
| Spec | Value |
|---|---|
| Source | YouTube URL (link, not upload) |
| Length | 30 seconds recommended, 2 min max |
| Format | Landscape preferred (Play autoplays) |
| Audio | Allowed and recommended |
| Content rule | Less restrictive — real people, narration, marketing intro all OK |
| Placement | Above screenshots on product page |
The 30-Second Video Structure
Use this beat-by-beat template (works for both platforms with adjustments):
| Time | Beat | iOS Rule | Play Rule |
|---|---|---|---|
| 0:00–0:02 | Hook — show the outcome, not the app | In-app footage only | Can use logo/intro, max 3s |
| 0:02–0:08 | Problem framing — text overlay states the pain | Text on app footage | Can cut to lifestyle b-roll |
| 0:08–0:20 | Core feature demo — the "how it works" walkthrough | Real screen recording, sped up 1.25–1.5× OK | Same |
| 0:20–0:26 | Social proof / breadth — quick cuts of other features, ratings, results | Must be in-app screens | Can show review screenshots |
| 0:26–0:30 | Resolution + CTA frame | Show outcome state, no "Download Now" CTA (Apple rejects) | "Get it free" CTA OK |
Poster frame choice (iOS): must be visually striking, no text-heavy. The 0:00 frame is what 80% of users see.
Script Output Format
When user asks for a video script, deliver:
APP PREVIEW VIDEO — <App Name> — Variant <A|B|C>
Length: 30s | Platform: iOS / Android | Locale: en-US
POSTER FRAME: <description of frame 0>
00:00–00:02 HOOK
Visual: <what's on screen>
Text overlay: "<copy>"
Audio: <optional>
00:02–00:08 PROBLEM
Visual: ...
Text overlay: "..."
[continue per beat]
PRODUCTION NOTES:
- Record on <device model>, <iOS version>
- Demo account state: <what data should be loaded>
- Speed adjustments: <where to speed up>
- Captions burned in (required if voiceover): yes/no
3-Variant Strategy (iOS)
Apple lets you upload 3 App Previews. Don't make 3 of the same — diversify by hook:
| Variant | Hook angle | When iOS shows it |
|---|---|---|
| A — Outcome | Result-led ("Sleep better in 7 days") | Default first preview |
| B — Demo | Feature walkthrough — pure UX | Second |
| C — Social proof | Numbers, results, testimonials in-app | Third |
User can reorder. Default to Outcome first unless category demands demo (e.g. complex tools).
Production Checklist
Before submission:
- Captured at native device resolution
- No "Download Now", "Available on App Store", or app icon overlays (Apple guideline 2.3.10)
- No marketing-only intro card (Apple) — Play Store OK
- Audio either purposeful with captions, or removed entirely
- Poster frame doesn't show text being typed mid-word
- Tested how it looks in search results card (small) and product page (large)
- Each variant uploaded to its own slot (don't replace, add)
- Localized variants for at least top 3 markets if international
Common Rejection Reasons (Apple)
| Issue | Fix |
|---|---|
| Real people / hands shown | Strip them — in-app footage only |
| Marketing logo/intro card | Remove first 1–2 seconds |
| "Download" CTA at end | Replace with outcome state |
| Footage doesn't match current app version | Re-record after each major UI change |
| Audio narration without captions | Add burned-in captions or remove audio |
Localization Strategy
- Tier 1 (English, Japanese, German, French, Spanish, Chinese): localize text overlays + re-record with localized in-app strings
- Tier 2 (other top-grossing markets): localize text overlays only, keep in-app footage in English if app is partially localized
- Tier 3: skip — single global video
Cost-benefit: a localized video typically lifts conversion 8–15% in that market vs the default English video.
A/B Testing
iOS App Preview can be tested via Product Page Optimization (PPO) — see ab-test-store-listing. Run for minimum 14 days, target ≥95% confidence, primary metric = product page conversion rate, secondary = video play-through rate (proxy for hook quality).
Cross-Skill Handoffs
- Static screenshot strategy for slots 1–10 →
screenshot-optimization - Run a PPO test on the video →
ab-test-store-listing - Localizing video text overlays per market →
localization - Video isn't in the right slot order or alongside the right screenshots →
screenshot-optimization
Related skills
More from eronred/aso-skills and the wider catalog.
aso-audit
When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Also use when the user mentions "ASO audit", "ASO score", "why am I not ranking", "listing review", or "optimize my app store page". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.
monetization-strategy
When the user wants to design or optimize their app's monetization — pricing, paywalls, subscriptions, or in-app purchases. Also use when the user mentions "pricing", "paywall", "subscription", "IAP", "how to monetize", "revenue optimization", "free trial", or "conversion to paid". For retention impact, see retention-optimization. For competitive pricing, see competitor-analysis.
keyword-research
When the user wants to discover, evaluate, or prioritize App Store keywords. Also use when the user mentions "keyword research", "find keywords", "search volume", "keyword difficulty", "keyword ideas", or "what keywords should I target". For implementing keywords into metadata, see metadata-optimization. For auditing current keyword performance, see aso-audit.
metadata-optimization
When the user wants to optimize App Store metadata — title, subtitle, keyword field, or description. Also use when the user mentions "optimize my title", "ASO metadata", "keyword field", "character limits", "app description", or "write my subtitle". For keyword discovery, see keyword-research. For full ASO audits, see aso-audit.
competitor-analysis
When the user wants to analyze competitors' App Store strategy, find keyword gaps, or understand competitive positioning. Also use when the user mentions "competitor analysis", "competitive research", "keyword gap", "what are my competitors doing", or "compare my app to". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.
screenshot-optimization
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.