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
```
Common anchors: `IPHONE_65` and `IPAD_PRO_3GEN_129`. Use `--all` for other iPhone sizes, Apple TV, Mac, Vision Pro, iMessage, or Watch.
## Local Audit Helper
After choosing target dimensions from ASC, inspect local screenshots with the bundled helper:
```bash
python3 "$PLUGIN_ROOT/skills/appstore-screenshot-validator/scripts/screenshot_audit.py" \
"./screenshots/iphone" --recursive --allow-size 1284x2778 --allow-rotated --fail-on-alpha
```
The helper reads PNG/JPEG headers only. It does not resize, rewrite, strip alpha, upload, or call ASC. Pass `--json` for machine-readable output.
## Workflow
1. Query current screenshot size requirements with `asc screenshots sizes --all`.
2. Run `screenshot_audit.py` against candidate PNG/JPEG files; fail on alpha and hidden Unicode filename spaces before upload.
3. Preserve originals. Write sanitized, alpha-stripped, resized, or color-converted images to a separate directory.
4. Use `sips` for macOS image rewrites only after selecting an ASC target size; `sips -z` takes height then width.
5. Run `asc screenshots validate` on the final directory, then `asc screenshots upload --dry-run`, then upload only after the dry-run is clean.
## Guardrails
Preserve o