# App preview video Human Guide

## What This Is For
Provides App Store Preview video specialist. It gives the agent a clearer input/output frame for content production: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the App preview video agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for app preview video.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the App preview video guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- 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
- [ ] 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)

## Decision Points And Nuance
The original skill emphasizes: Initial Assessment, Platform Specs (memorize), iOS App Preview, Google Play Promo Video, The 30-Second Video Structure, Script Output Format, 3-Variant Strategy (iOS), Production Checklist, Common Rejection Reasons (Apple), Localization Strategy.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- | Orientation | Portrait or landscape — must match screenshots |
- | Audio | Optional — most users see muted; subtitles required if audio carries info |
- | 0:20–0:26 | **Social proof / breadth** — quick cuts of other features, ratings, results | Must be in-app screens | Can show review screenshots |
- **Poster frame choice (iOS):** must be visually striking, no text-heavy. The 0:00 frame is what 80% of users see.
- Captions burned in (required if voiceover): yes/no
- Apple lets you upload 3 App Previews. Don't make 3 of the same — diversify by hook:
- [ ] Each variant uploaded to its own slot (don't replace, add)

## Copy-And-Paste Prompt
```text
Use the App preview video human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the eronred/aso-skills skill entry for `app-preview-video`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# 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

1. Check for `app-marketing-context.md` — read for app, audience, and core value
2. Ask for the **App ID** and **platform(s)** — iOS, Android, or both
3. Ask if they have **existing screen recordings** or need to capture fresh
4. Ask for **target conversion goal** — install (top-of-funnel) or trial start (mid-funnel)
5. 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
