asc-shots-pipeline
Orchestrate iOS screenshot automation with xcodebuild/simctl for build-run, AXe for UI actions, JSON settings and plan files, Koubou-based framing (`asc screenshots frame`), and screenshot upload (`asc screenshots upload`). Use when users ask for automated screenshot capture, AXe-driven simulator flows, frame composition, or screenshot-to-upload pipelines.
Security Assessment
About asc-shots-pipeline
The asc-shots-pipeline skill provides a comprehensive framework for automating iOS screenshot workflows, bridging the gap between app build, UI interaction, screenshot framing, and upload processes. It is designed to streamline the creation of app store-ready screenshots by integrating Xcode CLI tools for building and launching applications on simulators, AXe for automated UI interactions and screenshot captures, and Koubou-based framing for consistent visual presentation. This skill addresses the challenges developers face when manually capturing multiple screenshots across devices and orientations, providing an end-to-end pipeline that reduces repetitive tasks and ensures visual consistency.
FAQ
How do I start a screenshot workflow with asc-shots-pipeline?
Begin by creating or updating the settings JSON file at `.asc/shots.settings.json`, specifying your app bundle, project, scheme, simulator UDID, and paths for plan, raw screenshots, and framed screenshots. Then build and run your app on a simulator using Xcode CLI, followed by executing the AXe plan or minimal steps to capture screenshots.
Which devices are supported for framing screenshots?
Framing is handled via Koubou `0.18.1` and supports predefined devices such as `iphone-air` (default), `iphone-17-pro`, `iphone-17-pro-max`, `iphone-16e`, and `iphone-17`. You can list all supported frame devices using `asc screenshots list-frame-devices --output json`.
Can I skip framing and upload raw screenshots directly?
Yes, set `"frame_enabled": false` in the settings JSON and update `upload.source_dir` to point to the raw screenshots directory (e.g., `./screenshots/raw`).
What are the system requirements for using asc-shots-pipeline?
You need a macOS environment with Xcode CLI tools installed, Python for Koubou, and the AXe framework for UI interactions. Ensure Koubou `0.18.1` is installed for deterministic framing results.
How do I handle app bundle paths that differ from defaults?
If the app bundle path differs from the standard location, use `xcodebuild -showBuildSettings` to locate the derived app path and adjust your installation and launch commands accordingly.
Install asc-shots-pipeline
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill