skills.rest
pradeepmouli
pradeepmouliCOMMUNITY
Explore all skills by this author →
GitHub

axiom-xcode-debugging

Diagnose Xcode build and simulator issues with environment-first checks.

Updated Dec 23, 2025
Search Tags:#debugging#ios#environment#diagnostics#xcode#simulator
One-click install
npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-xcode-debugging-pradeepmouli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: axiom-xcode-debugging
Source: https://github.com/pradeepmouli/swift-template/tree/main/.agents/skills/axiom-xcode-debugging
Command: npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-xcode-debugging-pradeepmouli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers diagnose Xcode build and simulator issues by focusing on environment and simulator state before inspecting code, saving time and avoiding false code fixes.

Core Features & Use Cases

  • Environment-first diagnostics: check zombie xcodebuild processes, Derived Data size, and simulator states before debugging.
  • Targeted recovery steps: clean Derived Data, terminate stuck processes, and reset or reboot simulators to recover from flaky builds.
  • Scope and applicability: use when encountering BUILD FAILED, simulator boot failures, No such module errors after SPM changes, or intermittent test failures to isolate environment problems.

Quick Start

Run the mandatory environment checks first to identify and fix stale Derived Data, zombie xcodebuild processes, and stuck simulators before debugging code.

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 failures after SPM updates?▼

Xcode build failures after SPM updates can often be resolved by cleaning stale Derived Data, terminating zombie xcodebuild processes, and resetting simulator states to isolate environment issues from code problems.

Why does the iOS simulator say Unable to boot simulator?▼

The Unable to boot simulator error usually results from a stuck or corrupted simulator state. Diagnose the simulator environment by running simctl state checks and performing a safe simulator reboot or reset.

What is the best way to resolve No such module errors in Xcode?▼

The best way to resolve No such module errors in Xcode is to curate Derived Data and validate the environment first. This isolates whether stale build artifacts or SPM update issues are causing the missing module.

When should I clean Derived Data to fix intermittent iOS test failures?▼

You should clean Derived Data when experiencing intermittent iOS test failures or flaky builds. Checking Derived Data size and removing stale artifacts performs environment-first diagnostics to rule out corrupted build environments.

Does environment-first debugging work for macOS projects experiencing flaky builds?▼

Yes, environment-first debugging applies to both iOS and macOS projects experiencing flaky builds. It validates xcodebuild processes and simulator states to isolate environment issues before inspecting code.

Related Skills

Explore More Software Engineering Skills→
CharlesWiltgenCharlesWiltgen
1.1k

xcode-debugging

Diagnose Xcode environment issues and produce prioritized remediation plans.

Community
Basic
DengNaichenDengNaichen
34

axiom-build

Diagnose Xcode build failures and dependency conflicts in iOS and macOS workflows.

Community
Advanced
harivansh-afkharivansh-afk
3

axiom-xcode-debugging

Diagnose Xcode build and simulator environment issues with deterministic steps.

Community
Basic
tuliopc23tuliopc23

axiom-xcode-debugging

Diagnose Xcode build failures by checking Derived Data, simulators, and processes.

Community
Intermediate