# Asc Screenshot Upload

> Handle App Store screenshot requirements including automatic simulator capture and validated browser upload. Use when screenshots are missing or need to be uploaded for App Store submission.

- **Type:** Skill
- **Install:** `agentstack add skill-abdullah4ai-apple-developer-toolkit-asc-screenshot-upload`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Abdullah4AI](https://agentstack.voostack.com/s/abdullah4ai)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Abdullah4AI](https://github.com/Abdullah4AI)
- **Source:** https://github.com/Abdullah4AI/apple-developer-toolkit/tree/main/swiftship/internal/skills/data/features/asc-screenshot-upload

## Install

```sh
agentstack add skill-abdullah4ai-apple-developer-toolkit-asc-screenshot-upload
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ASC Screenshot Upload

## Two-Option Screenshot System

During pre-flight step 8, the user chooses how to provide screenshots:

### Automatic (Recommended)

Pre-flight builds the app for each required simulator, boots them, installs, launches, and captures the initial launch screen. Simulators are left running so you can capture additional screens.

After pre-flight, use AXe to navigate to key screens and capture more:

```bash
# See current screen elements
axe describe-ui --udid 

# Navigate to a screen
axe tap --id  --udid 

# Capture screenshot
xcrun simctl io  screenshot .png
```

Analyze the app's Swift source to identify important screens (ignore settings/preferences). Capture 3-5 screenshots showing the app's core functionality.

### Custom Upload

Browser UI with Apple validation:

- **Requirements checklist** at top shows which device types are needed (green checkmarks when fulfilled)
- Each uploaded image shows a **badge**: green with device type if dimensions match, red "Invalid size" if not
- **Upload Screenshots** button disabled until all required types have valid screenshots
- **Upload Anyway** escape hatch for incomplete uploads
- Summary line: "2/2 required types covered" or "1/2 — iPad 13" still needed"

## Device Family Requirements

The `device_family` field in `project_config.json` determines what's required:

| Device Family | Required Screenshots |
|---|---|
| `iphone` (default) | iPhone 6.9" (or 6.5" fallback) |
| `ipad` | iPad 13" |
| `universal` | iPhone 6.9" AND iPad 13" |

**iPad screenshots are mandatory for universal/iPad apps.** Submission will fail without them.

## Apple Screenshot Dimensions

| Device | Resolution (portrait) | Device Type |
|---|---|---|
| iPhone 6.9" | 1320x2868, 1290x2796, 1260x2736 | IPHONE_69 |
| iPhone 6.5" (fallback) | 1284x2778, 1242x2688 | IPHONE_65 |
| iPad 13" | 2064x2752, 2048x2732 | IPAD_PRO_13 |

Format: PNG or JPEG, RGB, no transparency. 1-10 screenshots per device type per locale.

## Screenshot Directory Convention

```
screenshots/
  auto/       # Automatic simulator captures
  upload/     # User-provided screenshots from browser upload
  framed/     # Framed screenshots ready for upload
```

## Uploading to App Store Connect

```bash
# Get the version localization ID
asc localizations list --version "VERSION_ID" --output json

# Upload screenshots
asc screenshots upload \
  --version-localization "LOC_ID" \
  --path "./screenshots/auto" \
  --device-type "IPHONE_69" \
  --output json
```

## Screenshot Status in System Prompt

The system prompt reports screenshot status:
- `available at  (device types: IPHONE_69, IPAD_PRO_13)` — ready
- `available at  (not yet validated)` — found but unchecked
- `NOT available` — missing, required before submission

If automatic capture was used, simulator UDIDs are provided for multi-screen capture via AXe.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Abdullah4AI](https://github.com/Abdullah4AI)
- **Source:** [Abdullah4AI/apple-developer-toolkit](https://github.com/Abdullah4AI/apple-developer-toolkit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-abdullah4ai-apple-developer-toolkit-asc-screenshot-upload
- Seller: https://agentstack.voostack.com/s/abdullah4ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.