axiom-analyze-crash
axiom-analyze-crash helps developers quickly decode crash logs from iOS and macOS apps, surfacing the underlying failure and recommending targeted solutions. Built on deep Apple platform expertise, it cuts through stack traces to reveal what actually went wrong—whether it's a memory issue, threading problem, or framework conflict—so you can fix it fast.
axiom-analyze-crash analyzes a single iOS or macOS crash log to identify the root cause and recommend a fix. It decodes stack traces, classifies crash patterns (force-unwrap, memory issues, concurrency problems, etc.), and surfaces the underlying failure so you can address it quickly.
AI-generated summary based on this skill's SKILL.md
Install
CharlesWiltgen/Axiom/axiom-analyze-crash · repository language: Go
git clone https://github.com/CharlesWiltgen/Axiom
cp -r Axiom/axiom-codex/skills/axiom-analyze-crash ~/.claude/skills/axiom-analyze-crashFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What can axiom-analyze-crash do with an iOS crash log?
axiom-analyze-crash analyzes a single iOS or macOS crash log to identify the root cause and recommend a fix. It decodes stack traces, classifies crash patterns (force-unwrap, memory issues, concurrency problems, etc.), and surfaces the underlying failure so you can address it quickly.
How does axiom-analyze-crash symbolicate crash files?
axiom-analyze-crash symbolicates crash frames and resolves dSYM UUID mismatches. It matches raw memory addresses in your crash report to human-readable function names and source locations, then diagnoses missing or mismatched dSYM files that prevent proper symbolication.
Can axiom-analyze-crash interpret exception codes and termination reasons?
Yes. axiom-analyze-crash interprets exception codes and termination reasons in crash reports, including watchdog violations (like 0x8BADF00D), jetsam OOM crashes, and main thread checker violations. It translates these codes into actionable diagnostics.
What caused my app to crash—how does axiom-analyze-crash help?
axiom-analyze-crash performs crash pattern identification and root cause analysis on your app's crash logs. It cuts through the stack trace to reveal whether the failure stems from a memory issue, threading problem, framework conflict, or other underlying cause, then recommends targeted solutions.
How do I use axiom-analyze-crash to parse .ips crash reports?
axiom-analyze-crash accepts .ips crash report files and parses them to extract diagnostic data. Feed it your iOS crash dump or macOS crash log, and it will symbolicate frames, classify the crash pattern, and interpret exception codes to help you understand and fix the problem.
What is axiom-analyze-crash's license?
axiom-analyze-crash is released under the MIT license, allowing free use, modification, and distribution in both open-source and commercial projects.
SKILL.md
rendered from the published skill — quoted content, verbatim
> Note: This audit may use Bash commands to run builds, tests, or CLI tools.
Crash Analyzer Agent
You are an expert at interpreting iOS/macOS crash reports. You lean on xcsym for the mechanics (parsing, dSYM discovery, symbolication, categorization) and focus your attention on what the user needs to do next.
Core Principle
Understand the crash before writing any fix. Running xcsym crash takes seconds and gives you every field you need. Do not hand-parse .ips JSON unless xcsym is unavailable.
Workflow
- Check for xcsym:
command -v xcsym
If present, run:
xcsym crash <file> --format=standard
Interpret the JSON directly. The pattern_tag field tells you the crash category (see table below). The images.missing and images.mismatched arrays tell you about dSYM problems. Use xcsym verify <file> for deeper dSYM diagnostics and xcsym find-dsym <uuid> to locate a specific dSYM.
The exit code narrows the triage path:
| Exit | Meaning | Next step |
|---|---|---|
| 0 | All images matched | Read |
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
axiom-codex/skills/axiom-analyze-crash/SKILL.md
axiom-codex/skills/axiom-analyze-crash/agents/openai.yaml