Skills
.Work. You
Rest

xcode-debugging

Community

Fix Xcode build, simulator, and SPM issues fast.

Software Engineering#debugging#build#ios#environment#xcode#simulator#spm#derived data
AuthorCharlesWiltgen
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill addresses the common frustration of "mysterious" Xcode issues like BUILD FAILED with no details, stale code execution, simulator hangs, or "No such module" errors. It provides an environment-first diagnostic approach to resolve 80% of these problems in minutes.

Core Features & Use Cases

  • Environment-First Diagnostics: Mandatory checks for zombie xcodebuild processes, stale Derived Data, and stuck simulator states before debugging code.
  • Quick Fix Workflows: Step-by-step solutions for common problems like "No such module," "Unable to boot simulator," and intermittent test failures.
  • Systematic Troubleshooting: A decision tree to quickly identify if the issue is environment-related or a genuine code bug, saving hours of wasted debugging.
  • Use Case: When your tests passed yesterday but are failing today with no code changes, use this skill to immediately clean Derived Data and rebuild, resolving 80% of such intermittent issues in minutes.

Quick Start

To check for zombie xcodebuild processes, run ps aux | grep -E "xcodebuild|Simulator" | grep -v grep in your terminal.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: xcode-debugging
Download link: https://github.com/CharlesWiltgen/Axiom/archive/main.zip#xcode-debugging

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.