ios-debugging

What problem does it solve?

This Skill eliminates the guesswork and wasted time when debugging iOS, macOS, watchOS, and visionOS apps, providing a systematic, evidence-based workflow to diagnose crashes, hangs, build errors, concurrency violations, memory leaks, and wrong runtime behavior instead of patching symptoms.

Core Features & Use Cases

• Crash & Hang Triage: Symbolicate and classify crash logs (EXC_BAD_ACCESS, SIGABRT, watchdog 0x8BADF00D, jetsam OOM), capture live backtraces with LLDB, and identify the root cause from the crashing thread's first app frame.
• Concurrency & Memory Debugging: Fix Swift 6 actor isolation violations, @MainActor/Sendable bugs, retain cycles, and memory leaks using sanitizers, Instruments, and structured inspection workflows.
• Proactive Bug Detection: Use the 7 assumption lenses to find hidden bugs in code that compiles and passes tests, and maintain a DEBUG_LOG knowledge base to log prevention rules and avoid recurring issues.
• Use Case: For example, when a user reports a crash after tapping a button on a specific screen, use this Skill to capture the backtrace, rule out the obvious symptom, identify the actual root cause (such as a dynamic UIColor provider crashing on the AsyncRenderer thread), fix it, and log a prevention rule to stop the bug from reappearing.

Quick Start

Use the ios-debugging skill to analyze the provided crash log or backtrace, identify the root cause of the reported iOS app issue, and deliver a step-by-step fix with a preventive rule to avoid recurrence.