Skills

Axiom Analyze Crash

Use when the user has a crash log (.ips, MetricKit JSON, legacy .crash text...

Install

npx skills add CharlesWiltgen/Axiom --skill axiom-analyze-crash -g -a claude-code -y
Repository
CharlesWiltgen/Axiom1.2k
Category
Engineering
Updated
4d ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Use when the user has a crash log (.ips, MetricKit JSON, legacy .crash text, .xccrashpoint bundle, or pasted text) that needs analysis.

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 neither xcsym nor the axiom_xcsym_crash MCP tool is available.

Workflow

  1. Check for xcsym:
command -v xcsym

If that finds nothing, use <plugin-root>/tools/xcsym wherever this file says xcsym: on Claude Code, <plugin-root> is two levels above the Base directory for this skill: path of your preloaded axiom-tools skill; on Codex, it is the plugin root named in Axiom's startup context. 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:

Read the whole SKILL.md on GitHub

More in Engineering