diagnose-crash

Diagnose program crashes from systemd-coredump core dumps on Fedora Asahi.

2|Updated May 18, 2022
One-click install
npx skills add https://github.com/saifulapm/dotfiles --skill diagnose-crash-saifulapm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagnose-crash
Source: https://github.com/saifulapm/dotfiles/tree/main/home/dot_claude/skills/diagnose-crash
Command: npx skills add https://github.com/saifulapm/dotfiles --skill diagnose-crash-saifulapm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an application segfaults, aborts, or disappears with a "Process crashed" notification, it is hard to tell what actually happened, whose bug it is, and whether user data was lost. This Skill provides an evidence-based workflow for diagnosing crashes from systemd-coredump core dumps on a Fedora Asahi (aarch64) machine. ## Core Features & Use Cases - Evidence gathering: Reads backtraces and command lines via coredumpctl, correlates crash timestamps against filesystem mtimes, journal entries, and recent dnf package updates, and rules out OOM kills from systemd-oomd first. - Symbolization: Uses Fedora's debuginfod server with gdb to resolve stack frames, handles aarch64-specific concerns, and treats core dumps as sensitive memory copies that must be written to mktemp paths and deleted afterward. - Attribution and reporting: Separates proven facts from inference, distinguishes dotfiles bugs from upstream project bugs and Asahi kernel/mesa issues, and defines strict conditions for filing upstream issues with gh (verified bug, explicit user consent, authenticated CLI, duplicate search first). - Use Case: A user asks "why does my file manager keep crashing?" The Skill checks coredumpctl list for a pattern, correlates the crash time with a recent package update, symbolizes the stack via debuginfod, and reports the likely mechanism plus whether it is a dotfiles or upstream bug. ## Quick Start Ask the assistant to diagnose why a specific program crashed using the most recent core dump from coredumpctl.

Frequently Asked Questions about diagnose-crash

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

FAQPage Schema
How do I diagnose a segfault from a core dump on Linux?▼

Start with coredumpctl info <pid> to see the backtrace and the command line the process ran. Then extract the core with coredumpctl dump and symbolize it in gdb using Fedora's debuginfod server for debug symbols.

How to get debug symbols for a crash backtrace on Fedora?▼

Fedora runs a public debuginfod server already configured in /etc/debuginfod, so gdb fetches symbols automatically when DEBUGINFOD_URLS is set. The local fallback is dnf debuginfo-install <package> when debuginfod has nothing.

Why did my application crash right after a system update?▼

A crash starting immediately after an update usually points at the update itself. Correlate the crash timestamp with dnf history and journalctl entries around that moment to identify which package changed.

Can a process crash be caused by the OOM killer instead of a bug?▼

Yes. A process killed by the OOM killer is not a bug in that process. Check free -h and journalctl -u systemd-oomd, since this machine runs an aggressive memory-pressure tier with swap on zram.

When should I file an upstream bug report for a crash?▼

Only when the bug is verified on evidence, the user explicitly approves the exact title and body, and gh auth status succeeds. Search existing open and closed issues first, and include a symbolized stack plus reproduction details.