What does the Xcode Debugging skill do?

This skill provides Claude with a systematic, environment-first diagnostic workflow to identify and resolve common Xcode issues like stale Derived Data, zombie processes, and simulator hangs before you waste time debugging actual code logic.

Can this skill help with Swift Package Manager (SPM) errors?

Yes. It specifically addresses 'No such module' errors and phantom dependency issues caused by SPM caching, providing automated commands to clear caches and force a clean rebuild of dependencies.

Does it support visual verification for UI fixes?

Absolutely. The skill includes workflows for capturing simulator screenshots and stabilizing UI states, allowing Claude to visually confirm that layout changes and styling tweaks have been applied correctly.

When should I use this skill?

Use this skill when you encounter 'BUILD FAILED' with no clear error, when your app runs old code despite changes, or when the iOS simulator is stuck 'Booting' or fails to install your app.

How does this skill improve my mobile development workflow?

It reduces debugging time from hours to minutes by prioritizing environment health. By running mandatory checks on processes and caches first, it eliminates 'mysterious' build failures that aren't caused by your code.

Xcode Debugging: Claude Code Skill for iOS & macOS Issues

Xcode Debugging provides a battle-tested framework for troubleshooting iOS and macOS development environments, prioritizing system diagnostics over code changes to resolve the 80% of issues caused by environment instability. It helps developers identify and fix "mysterious" build failures, stale caches, and simulator malfunctions by providing automated checks for Derived Data, active processes, and simulator states. By following its structured decision trees and recovery workflows, developers can significantly reduce time wasted on phantom bugs, ensuring that their development environment remains clean and predictable.

主な機能

01Environment-first diagnostic workflow for identifying stale Derived Data and zombie processes

02Automated resolution for 'No such module' errors caused by Swift Package Manager caching

03Visual verification tools for capturing simulator screenshots and stabilizing UI states

04Systematic simulator recovery patterns including state verification, resets, and nuclear options

05Decision trees for troubleshooting intermittent test failures and stale build executions

0661 GitHub stars

ユースケース

01Resolving 'Unable to boot simulator' or 'BUILD FAILED' errors with no clear code cause

02Fixing 'phantom' build errors where old code executes despite new changes and restarts

03Cleaning up developer environments when Xcode performance degrades or tests hang indefinitely

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add charleswiltgen/axiom xcode-debugging

For use in Claude.ai and ChatGPT

Download Skill