asc-shots-pipeline

Automate iOS screenshot capture, framing, and App Store Connect upload via CLI pipelines.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/dustinober1/sundee-fundee-ios --skill asc-shots-pipeline-dustinober1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: asc-shots-pipeline
Source: https://github.com/dustinober1/sundee-fundee-ios/tree/main/SundeeFundeeApp/.agents/skills/asc-shots-pipeline
Command: npx skills add https://github.com/dustinober1/sundee-fundee-ios --skill asc-shots-pipeline-dustinober1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires koubou.

What problem does it solve? Producing App Store screenshots manually across devices and locales is slow and error-prone. This Skill orchestrates the full pipeline: building and launching an iOS app on simulators, driving the UI with AXe, framing screenshots with Koubou, and uploading them to App Store Connect with the asc CLI. ## Core Features & Use Cases - Plan-driven capture: Define screenshot steps in a JSON plan (.asc/screenshots.json) and execute them with asc screenshots run or AXe primitives like tap, type, and screenshot. - Deterministic framing: Frame raw screenshots with Koubou 0.18.1 pinned device frames (e.g., iphone-air, iphone-17-pro) via asc screenshots frame. - Review and upload workflow: Generate review artifacts, approve them, then upload with asc screenshots upload or the plan/apply flow for multi-locale batches. - Multi-locale and parallel capture: Map locales to dedicated simulator UDIDs, set simulator-wide locale defaults, and run captures in parallel for speed. - Use Case: You need App Store screenshots in five locales. Configure per-locale simulators, run the parallel capture script, frame all outputs, review them, and upload each locale set to its version localization. ## Quick Start Ask the agent to build the app on a booted simulator, run the screenshot plan in .asc/screenshots.json, frame the results for iphone-air, and upload them to App Store Connect.

Frequently Asked Questions about asc-shots-pipeline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate iOS App Store screenshots from the command line?▼

Build and install the app with xcodebuild and simctl, then run a JSON capture plan with asc screenshots run or drive the UI with AXe commands. Frame results with asc screenshots frame and upload with asc screenshots upload.

How do I capture localized screenshots on iOS simulators?▼

Assign each locale a dedicated simulator UDID and set AppleLanguages and AppleLocale via simctl spawn defaults write before launching. Do not use simctl launch -e, since environment variables do not reliably switch app language.

What tool frames iOS screenshots with device bezels?▼

The asc screenshots frame command uses Koubou pinned to version 0.18.1 for deterministic framing. Supported devices include iphone-air, iphone-17-pro, iphone-17-pro-max, iphone-16e, iphone-17, and mac.

Why does screenshot framing fail with a Koubou version or frame error?▼

Framing fails if Koubou is not pinned to 0.18.1 or device frames are missing. Reinstall with pip install koubou==0.18.1 and run kou setup-frames once with network access.

Can I run screenshot captures for multiple locales in parallel?▼

Yes, run one locale per simulator UDID in parallel using backgrounded bash jobs or xargs -P. Each simulator gets its own locale defaults, then asc screenshots capture runs concurrently before a shared framing step.