axiom-xcode-debugging

Diagnose Xcode build and simulator environment issues with deterministic steps.

3|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/harivansh-afk/claude-code-vertical --skill axiom-xcode-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-xcode-debugging
Source: https://github.com/harivansh-afk/claude-code-vertical/tree/main/skill-index/skills/axiom-xcode-debugging
Command: npx skills add https://github.com/harivansh-afk/claude-code-vertical --skill axiom-xcode-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers quickly identify and resolve environment-related issues that block Xcode builds and simulator runs, reducing time spent on symptoms rather than root causes.

Core Features & Use Cases

  • Environment-first diagnostics: checks Derived Data size, zombie xcodebuild processes, and simulator states before code changes.
  • Guided remediation: provides deterministic steps to fix common failures like BUILD FAILED, Unable to boot simulator, and No such module.
  • Verification workflow: guides you to re-run builds and tests to confirm fixes in real scenarios.

Quick Start

  • Run mandatory environment checks: ps aux | grep -E "xcodebuild|Simulator" | grep -v grep; du -sh ~/Library/Developer/Xcode/DerivedData; xcrun simctl list devices
  • Restart and reset simulators if needed: xcrun simctl shutdown all; xcrun simctl erase all; killall -9 Simulator
  • Rebuild and verify: xcodebuild -scheme YourScheme -destination 'platform=iOS Simulator,name=iPhone 14'

Frequently Asked Questions about axiom-xcode-debugging

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

FAQPage Schema
How do I fix Xcode build errors by clearing stale Derived Data?

To resolve an iOS simulator that is unable to boot, run `xcrun simctl shutdown all` followed by `xcrun simctl erase all`, and kill any zombie Simulator processes using `killall -9 Simulator` before attempting to boot the device again.

Why does Xcode show "No such module" even when my dependencies are installed?

Diagnose iOS simulator blocking issues by listing device states with `xcrun simctl list devices`, shutting down all simulators, and erasing them to eliminate environment conflicts before running new builds.

What is the best way to diagnose environment-related Xcode build failures?

The best way to diagnose environment-related Xcode build failures is prioritizing environment checks over code changes, specifically inspecting Derived Data size, active xcodebuild processes, and simulator states through guided deterministic steps.

How do I verify an Xcode simulator fix after resetting the environment?

Verify an Xcode simulator fix after resetting the environment by re-running the build and tests using `xcodebuild -scheme YourScheme -destination 'platform=iOS Simulator,name=iPhone 14'` to confirm the deterministic remediation resolved the failure.