asc-app-previews
Manage App Store app preview video sets and uploads using the `asc` CLI tool. Use this skill when: (1) Listing preview sets for a localization: "asc app-preview-sets list --localization-id ID" (2) Creating a preview set: "asc app-preview-sets create --localization-id ID --preview-type IPHONE_67" (3) Listing previews in a set: "asc app-previews list --set-id ID" (4) Uploading a preview video: "asc app-previews upload --set-id ID --file preview.mp4" (5) User says "upload app preview", "add preview video", "create preview set", or "list previews"
How do I install this agent skill?
npx skills add https://github.com/tddworks/asc-cli-skills --skill asc-app-previewsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill manages App Store video previews using the asc CLI tool. It interacts with local files and executes shell commands using user-supplied parameters.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
2 files scanned · No issues
What does this agent skill do?
asc App Previews
Manage App Store preview video sets and video uploads via the asc CLI.
Commands
List preview sets for a localization
asc app-preview-sets list --localization-id <LOCALIZATION_ID>
Create a preview set
asc app-preview-sets create \
--localization-id <LOCALIZATION_ID> \
--preview-type <PREVIEW_TYPE>
--preview-type raw values have no APP_ prefix — unlike screenshot display types.
Common values: IPHONE_67, IPHONE_65, IPAD_PRO_3GEN_129, APPLE_TV, APPLE_VISION_PRO, DESKTOP.
See preview-types.md for all valid values grouped by device.
List previews in a set
asc app-previews list --set-id <SET_ID>
Upload a preview video
asc app-previews upload \
--set-id <SET_ID> \
--file path/to/preview.mp4 \
[--preview-frame-time-code 00:00:05]
- Accepted formats:
.mp4,.mov,.m4v --preview-frame-time-codesets the poster frame shown in the App Store- Upload is a 3-step API flow: POST reserve → PUT chunks → PATCH MD5 confirm
State Fields
AppPreview has two independent state fields (unlike screenshots which only have one):
| Field | States | Meaning |
|---|---|---|
assetDeliveryState | AWAITING_UPLOAD, UPLOAD_COMPLETE, COMPLETE, FAILED | Upload progress |
videoDeliveryState | AWAITING_UPLOAD, UPLOAD_COMPLETE, PROCESSING, COMPLETE, FAILED | Video encoding |
videoDeliveryState: "COMPLETE" = video ready. PROCESSING is unique to previews (absent on screenshots).
Nil fields are omitted from JSON output. mimeType values containing / are escaped as \/ by JSONEncoder (e.g. "video\/mp4").
CAEOAS Affordances
Every JSON response includes affordances with ready-to-run follow-up commands:
AppPreviewSet:
{
"affordances": {
"listPreviews": "asc app-previews list --set-id <SET_ID>",
"listPreviewSets": "asc app-preview-sets list --localization-id <LOCALIZATION_ID>"
}
}
AppPreview:
{
"affordances": {
"listPreviews": "asc app-previews list --set-id <SET_ID>"
}
}
Typical Workflow
# 1. Find the localization ID
asc version-localizations list --version-id <VERSION_ID> --output table
# 2. Create a preview set for the target device
asc app-preview-sets create \
--localization-id <LOCALIZATION_ID> \
--preview-type IPHONE_67
# 3. Upload the video (copy --set-id from affordances in step 2)
asc app-previews upload \
--set-id <SET_ID> \
--file preview.mp4 \
--preview-frame-time-code 00:00:05
# 4. Check processing state
asc app-previews list --set-id <SET_ID> --pretty
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tddworks/asc-cli-skills/asc-app-previews">View asc-app-previews on skillZs</a>