simulator-utils

Resize iOS Simulator screenshots and run simctl device and app workflows.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill simulator-utils-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simulator-utils
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/apple-skills/skills/simulator-utils
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill simulator-utils-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents iOS Simulator screenshots from failing API image size limits and streamlines common simulator actions like booting devices, installing apps, launching, and capturing screenshots.

Core Features & Use Cases

  • Screenshot + Resize (Required): Ensures screenshots are downsampled to keep maximum dimensions under 2000px to avoid multi-image request rejections.
  • Device & App Operations: Boot/shutdown/erase simulators and install/launch/terminate/uninstall apps using consistent simctl workflows.
  • Practical Use Cases: Take resized screenshots for documentation, QA reports, or Claude-driven visual analysis workflows without manual image editing.

Quick Start

Use simulator-utils to take an iOS Simulator screenshot and automatically resize it to a safe maximum size for API submission.

Frequently Asked Questions about simulator-utils

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

FAQPage Schema
Why do my iOS Simulator screenshots fail API image size limits?

iOS Simulator screenshots fail API image size limits because raw captures exceed maximum pixel thresholds. Resizing screenshots to under 2000px using sips --resampleHeightWidthMax 1800 downsamples images, preventing multi-image request rejections during automated review pipelines.

How do I capture and resize iOS Simulator screenshots for documentation?

Capture and resize iOS Simulator screenshots by combining xcrun simctl io booted screenshot with sips --resampleHeightWidthMax 1800. This workflow automatically downsamples images to safe maximum dimensions, generating reliable screenshots for QA reports and documentation without manual editing.

Can I boot devices and install apps using simctl workflows?

You can boot, shutdown, and erase simulators, plus install, launch, terminate, and uninstall apps using consistent simctl workflows. These commands streamline common iOS development tasks alongside the core screenshot capture and resizing functionality.

Does simulator-utils work with Claude-driven visual analysis workflows?

Simulator-utils works with Claude-driven visual analysis workflows by providing resized screenshots that meet API submission requirements. The tool ensures captured images are downsampled to safe dimensions, enabling automated review pipelines to process screenshots without manual image editing.

What's the best way to automate iOS Simulator screenshot resizing for review pipelines?

Automate iOS Simulator screenshot resizing by applying sips --resampleHeightWidthMax 1800 after capturing with xcrun simctl io booted screenshot. This approach guarantees screenshots remain under 2000px maximum dimensions, preventing API image size failures in automated review and documentation pipelines.