Linux Kernel Crash Debug

Linux Kernel Crash Debug Skill

[中文文档](README_CN.md)

Welcome to **Linux Kernel Crash Debug Skill**! This is a Claude Code skill that helps you debug Linux kernel crashes using the crash utility.

Features

• Quick Start Guide: Essential commands and debugging workflow
• Evidence-First Triage: Artifact validation, failure timeline, competing hypotheses, and confidence reporting
• Complete Command Reference: All crash utility commands with examples
• Advanced Techniques: Memory analysis, linked list traversal, address translation
• Production Detection: pstore/ramoops, watchdogs, KFENCE, KCSAN, and drgn automation
• Real-world Cases: Kernel BUG, deadlock, OOM, NULL pointer, stack overflow
• vmcore Knowledge: ELF format, VMCOREINFO, dump file types

Installation

# Download the skill file
git clone https://github.com/crazyss/linux-kernel-crash-debug.git

# Install in Claude Code
claude skill install linux-kernel-crash-debug.skill

Quick Start

# Start crash session
crash vmlinux vmcore

# Basic debugging flow
crash> sys              # Check panic reason
crash> log              # View kernel log
crash> bt               # Backtrace
crash> struct     # Inspect data structures
crash> kmem       # Memory analysis

Structure

linux-kernel-crash-debug/
├── SKILL.md                    # Main skill file (English)
├── SKILL_CN.md                 # Chinese version of skill
├── README.md                   # English documentation
├── README_CN.md                # Chinese documentation
├── CONTRIBUTING.md             # Contribution guide
├── LICENSE                     # MIT License
├── CLAUDE.md                   # Claude Code project config
├── scripts/                    # Utility scripts
│   └── agent-crash.sh          # Agent-safe crash wrapper
├── references/                 # Detailed documentation
│   ├── advanced-commands.md    # In-depth command usage
│   ├── agentic-heuristics.md   # Agent