crash-debugging

Symbolicate iOS crash logs with dSYM files to identify root causes.

179|17|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/conorluddy/xclaude-plugin --skill crash-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crash-debugging
Source: https://github.com/conorluddy/xclaude-plugin/tree/main/skills/crash-debugging
Command: npx skills add https://github.com/conorluddy/xclaude-plugin --skill crash-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps iOS developers transform cryptic crash logs into actionable insights, enabling faster root-cause analysis.

Core Features & Use Cases

  • Crash log retrieval: Locate and gather logs from simulators, devices, and TestFlight releases.
  • Symbolication & analysis: Map addresses to symbols using dSYM files and analyze stack traces to identify root causes.
  • Real-world scenarios: Reproduce issues locally, validate fixes, and stabilize releases by addressing common crash patterns.

Quick Start

Symbolicate the latest crash log for MyApp using the available dSYM and return a readable analysis with top frame and recommended fixes.

Frequently Asked Questions about crash-debugging

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

FAQPage Schema
How do I symbolicate an iOS crash log using dSYM files?

You symbolicate an iOS crash log by mapping memory addresses to readable symbols using matching dSYM files and standard Xcode tools like atos, dwarfdump, or symbolicatecrash to reveal root cause stack frames.

Why does my iOS crash report show unreadable memory addresses instead of function names?

Unreadable memory addresses in an iOS crash report appear when the matching dSYM file is missing or not applied during symbolication, preventing the mapping of addresses to recognizable function names and stack frames.

Can I retrieve and analyze TestFlight crash logs for real devices?

Yes, you can retrieve and analyze TestFlight crash logs for real devices by gathering diagnostic reports and applying dSYM symbolication to identify the actionable root cause of the crash.

What is the best way to analyze iOS crash stack traces to find the root cause?

The best way to analyze iOS crash stack traces is to symbolicate the memory addresses using dSYM files and then examine the top frames to identify the exact line of code and actionable root cause.

Do I need Xcode tools to symbolicate a crash log from an iOS Simulator?

Yes, you need standard Xcode tools like atos and dwarfdump along with the matching dSYM file to symbolicate a crash log from an iOS Simulator and successfully map memory addresses to symbols.