If you've ever had App Store Connect reject your screenshots because they're 2 pixels off or have alpha transparency, this skill is the workflow you need. It wraps the `asc` CLI and macOS `sips` to validate, resize, and strip alpha from screenshots before upload. The key insight is treating `asc screenshots sizes` as the source of truth instead of hardcoding dimensions that go stale when Apple changes requirements. It also handles the annoying Unicode space bug in macOS screenshot filenames and includes a clever JPEG round-trip trick to remove alpha channels. The guardrails are smart: always validate before upload, never overwrite originals, and don't stretch images across incompatible aspect ratios unless you're okay with the distortion.

skills.sh installs
5.3K
GitHub stars
1.1K
last updated
Aug 21, 2026

Install

$ npx -y skills add rorkai/app-store-connect-cli-skills --skill asc-screenshot-resize --agent claude-code

Installs into .claude/skills of the current project.

Files

asc screenshot resize

Use this skill to prepare screenshots for App Store Connect. Do not rely on a hard-coded dimension table in this skill; the CLI owns the current size matrix.

Source of truth

Always discover current accepted sizes from asc first:

asc screenshots sizes --output table
asc screenshots sizes --all --output table

For local validation before upload:

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 current device-type anchors:

  • IPHONE_65 for the common 6.5-inch iPhone screenshot set.
  • IPAD_PRO_3GEN_129 for the common 12.9/13-inch iPad screenshot set.

Run asc screenshots sizes --all when targeting other display types such as 6.9-inch iPhone, Apple TV, Mac, Vision Pro, iMessage, or Watch.

Workflow

1. Sanitize filenames

macOS screenshots can contain hidden Unicode spaces that make tools fail with "not a valid file". Sanitize before batch work:

Sponsors

Details

Repository
github.com/rorkai/app-store-connect-cli-skills
Categories
Mobile Development, CLI & Terminal
First seen
Jun 3, 2026

More from rorkai/app-store-connect-cli-skills

All 23
1android avatarr8-analyzerandroid/skillsAnalyzes Android build files and R8 keep rules to identify redundancies, broad package-wide rules, and rules that subsume library consumer keep rules. Use when 3.6Kskills.sh installs
2rorkai avatarasc-apple-adsrorkai/app-store-connect-cli-skillsUse when managing Apple Ads with asc, including auth, org lookup, campaigns, ad groups, ads, keywords, reports, raw API calls, and safe live testing.3.2Kskills.sh installs
3rudrankriyam avatarasc-cli-usagerudrankriyam/app-store-connect-cli-skillsasc cli usage2.7Kskills.sh installs
4rudrankriyam avatarasc-metadata-syncrudrankriyam/app-store-connect-cli-skillsasc metadata sync2.5Kskills.sh installs
5rudrankriyam avatarasc-id-resolverrudrankriyam/app-store-connect-cli-skillsasc id resolver2.4Kskills.sh installs
6rudrankriyam avatarasc-build-lifecyclerudrankriyam/app-store-connect-cli-skillsasc build lifecycle2.3Kskills.sh installs