skills.rest
tuliopc23
tuliopc23COMMUNITY
Explore all skills by this author →
Website𝕏@tuliopinheiro_GitHub

axiom-xcode-debugging

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

Updated Dec 3, 2025
Search Tags:#debugging#xcode#simulator#build failures#ios development#derived data#macos development
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-xcode-debugging-tuliopc23
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: axiom-xcode-debugging
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-xcode-debugging
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-xcode-debugging-tuliopc23

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses common and frustrating Xcode build and test failures by systematically diagnosing and resolving environment-related issues before diving into code.

Core Features & Use Cases

  • Environment First Diagnostics: Prioritizes checking for stale Derived Data, simulator hangs, and zombie processes.
  • Automated Cleanup: Provides commands to clean Derived Data, reset simulators, and kill stuck processes.
  • Use Case: When your Xcode build fails with cryptic errors or tests suddenly start failing without code changes, this Skill guides you through quick environment checks and fixes that resolve 80% of such issues in minutes.

Quick Start

Run the mandatory first steps to check processes, Derived Data size, and simulator states.

Frequently Asked Questions about axiom-xcode-debugging

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

FAQPage Schema
Why does my Xcode build fail with "No such module" errors after making no code changes?▼

Xcode build failures with "No such module" errors often stem from stale Derived Data or corrupted simulator states. Systematically checking and cleaning these environment variables resolves the majority of cryptic build issues without requiring code modifications.

How do I reset iOS simulators that are hanging or crashing during tests?▼

To reset hanging or crashing iOS simulators, you can run automated simulator reset commands. This process clears unresponsive simulator states and zombie processes, restoring a clean testing environment for your iOS development workflow.

What is the best way to fix Xcode build failures caused by zombie processes on macOS?▼

The best way to fix Xcode build failures caused by zombie processes is to systematically terminate stuck processes. Automated cleanup commands kill these lingering background tasks to restore a clean build environment on your macOS development machine.

Can I use automated cleanup commands to clear stale Derived Data in Xcode?▼

Yes, you can use automated cleanup commands to clear stale Derived Data in Xcode. This environment-first diagnostic approach removes corrupted build artifacts, directly addressing sudden test crashes and unresolved build failures efficiently.

When should I check the Xcode environment instead of debugging my application code?▼

You should check the Xcode environment first when builds suddenly fail or tests start crashing without any code changes. Prioritizing environment diagnostics like Derived Data size and simulator states resolves 80% of such issues quickly.

Related Skills

Explore More Software Engineering Skills→
Pjpj42Pjpj42

clean

Clean Xcode build artifacts and reset the iOS simulator.

Community
Intermediate
harivansh-afkharivansh-afk
3

axiom-xcode-debugging

Diagnose Xcode build and simulator environment issues with deterministic steps.

Community
Basic
igor-kupczynskiigor-kupczynski

ios-debugger-agent

Build, run, and debug iOS applications on booted simulators using XcodeBuildMCP.

Community
Advanced
enbyaugustenbyaugust
30

boot-local

Restart Worker, Edge Functions, and Dev Server on ports 8080 and 3001.

Community
Basic