Skill

ios-simulator-debugger

Builds, runs, and debugs iOS simulator apps using XcodeBuildMCP for UI inspection, screenshots, gesture simulation, and log capture.

iOS

mobile

npx claudepluginhub xopoko/build-swift-apps --plugin build-swift-apps

Popularity

Stars

Forks

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/build-swift-apps:ios-simulator-debugger

User invocable

Model invocable

Inline context

Default effort

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

Use XcodeBuildMCP for simulator control, build/run, UI inspection, screenshots, interaction, and logs.

Supporting Files

agents/openai.yaml

SKILL.md

33 lines · ~490 tokens

Similar Skills

ios-debugger-agent

39.9k

Builds, launches, and debugs iOS apps on a booted simulator via XcodeBuildMCP. Automates UI interaction, screenshot capture, and log collection for runtime inspection.

1 file

antigravity-awesome-skills

test-xcode

16.9k

Builds, installs, launches iOS apps on simulator using XcodeBuildMCP. Captures screenshots and logs to verify UI, check for crashes, and test key screens.

compound-engineering

xcode-build

134

Builds and runs iOS/macOS apps with xcodebuild and xcrun simctl. Manages simulators, compiles Swift, runs UI/unit tests, captures logs/screenshots, automates interactions.

2 files4 tools

xcode-build-skill

Stats

LanguagePython

Stars20

Forks2

MaintenanceExcellent

Last CommitJun 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Stats

Actions

Help us improve

Share bugs, ideas, or general feedback.

iOS Simulator Debugger

Use XcodeBuildMCP for simulator control, build/run, UI inspection, screenshots, interaction, and logs.

Workflow

Discover a booted simulator with mcp__XcodeBuildMCP__list_sims. If none is booted, ask the user to boot one unless they asked you to boot it.

Set defaults with mcp__XcodeBuildMCP__session-set-defaults: projectPath or workspacePath, scheme, simulatorId, optional configuration: "Debug" and useLatestOS: true.

Build/run with mcp__XcodeBuildMCP__build_run_sim when requested. If the build fails, inspect output and retry only when justified, optionally with preferXcodebuild: true.

After a successful run, verify launch with mcp__XcodeBuildMCP__describe_ui or mcp__XcodeBuildMCP__screenshot before UI interaction.

If only launch is requested, use mcp__XcodeBuildMCP__launch_app_sim. If bundle id is unknown, call mcp__XcodeBuildMCP__get_sim_app_path then mcp__XcodeBuildMCP__get_app_bundle_id.

Interaction

Describe before acting: mcp__XcodeBuildMCP__describe_ui.

Tap by id or label first; coordinates only when needed.

Type after focusing a field with mcp__XcodeBuildMCP__type_text.

Use mcp__XcodeBuildMCP__gesture for scrolls and edge swipes.

Capture visual proof with mcp__XcodeBuildMCP__screenshot.

Logs

Start capture with mcp__XcodeBuildMCP__start_sim_log_cap and the app bundle id. Stop with mcp__XcodeBuildMCP__stop_sim_log_cap and summarize important lines. For console output, set captureConsole: true and relaunch if required.

Troubleshooting

Wrong app means verify scheme/bundle id. Non-hittable elements require fresh describe_ui after layout changes. Do not keep interacting after an unhandled build or launch failure.