Why does this skill prioritize environment checks over code debugging?

Statistical analysis of Apple development workflows shows that roughly 80% of 'mysterious' errors are caused by environmental factors like stale caches, stuck simulators, or zombie processes rather than logical code bugs.

Can this skill help with stuck simulators?

Yes, it uses simctl to diagnose simulator states and provides a tiered recovery path including shutdown, erasing specific devices, and force-quitting the Simulator app.

How does it resolve 'No such module' errors?

It implements a specific workflow to clear Swift Package Manager (SPM) caches and Derived Data, forcing a clean rebuild which typically resolves module resolution failures after dependency changes.

What tools are included for visual verification?

The skill integrates with Axiom tools to take screenshots of the simulator directly from the CLI, allowing you to verify UI fixes and layout changes without manual interaction.

Xcode Build & Environment Debugging

Name: Xcode Build & Environment Debugging
Author: CharlesWiltgen

byCharlesWiltgen

•

233

Mobile Development

Diagnoses and resolves Xcode build failures, simulator hangs, and environment inconsistencies using a systematic, environment-first approach.

概要

The axiom-xcode-debugging skill optimizes the development workflow for iOS, macOS, watchOS, and tvOS by prioritizing environment health over code-level debugging. It provides automated diagnostics to identify stale Derived Data, zombie xcodebuild processes, and stuck simulators—the root cause of 80% of 'mysterious' Apple platform build errors. By following mandatory first steps and recovery patterns, developers can resolve issues like 'Unable to boot simulator' or 'No such module' in minutes rather than hours, ensuring a clean and reliable build environment.

主な機能

Simulator state recovery and simctl troubleshooting
Systematic environment-first diagnostic checklists
233 GitHub stars
Visual fix verification using simulator screenshots
Automated Derived Data and SPM cache cleanup workflows
Zombie process detection and safe termination

ユースケース

Recovering from simulator hangs and 'Unable to boot' state errors
Fixing 'No such module' errors and phantom SPM dependency issues
Resolving 'BUILD FAILED' errors that persist despite no code changes

概要

主な機能

Simulator state recovery and simctl troubleshooting
Systematic environment-first diagnostic checklists
233 GitHub stars
Visual fix verification using simulator screenshots
Automated Derived Data and SPM cache cleanup workflows
Zombie process detection and safe termination

ユースケース

Recovering from simulator hangs and 'Unable to boot' state errors
Fixing 'No such module' errors and phantom SPM dependency issues
Resolving 'BUILD FAILED' errors that persist despite no code changes