appstore-screenshot-validatorlisted
Install: claude install-skill Xopoko/plug-n-skills
# App Store Screenshot Validator
Prepare screenshots for App Store Connect. Do not hard-code Apple size tables here; `asc screenshots sizes` is the source of truth.
## Source of Truth
```bash
asc screenshots sizes --output table
asc screenshots sizes --all --output table
```
Validate locally before upload:
```bash
asc screenshots validate --path "./screenshots/iphone" --device-type "IPHONE_65" --output table
asc screenshots validate --path "./screenshots/ipad" --device-type "IPAD_PRO_3GEN_129" --output table
```
Common anchors: `IPHONE_65` and `IPAD_PRO_3GEN_129`. Use `--all` for other iPhone sizes, Apple TV, Mac, Vision Pro, iMessage, or Watch.
## Workflow
1. Sanitize filenames when screenshots contain hidden Unicode spaces:
```bash
python3 -c "import os
for f in os.listdir('.'):
clean = f.replace('\u202f', ' ')
if f != clean:
os.rename(f, clean)
print(f'Renamed: {clean}')"
```
2. Inspect size/alpha/color:
```bash
sips -g pixelWidth -g pixelHeight -g hasAlpha -g space screenshot.png
```
3. Strip alpha when needed; App Store Connect rejects alpha:
```bash
sips -s format jpeg input.png --out /tmp/asc-screenshot-no-alpha.jpg
sips -s format png /tmp/asc-screenshot-no-alpha.jpg --out output.png
rm /tmp/asc-screenshot-no-alpha.jpg
```
4. Resize only after choosing a target from `asc screenshots sizes --all`; `sips -z` takes height then width:
```bash
mkdir -p resized
for f in *.png; do