Linux Kernel Crash Debug Skill

中文文档

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
• Targeted Evidence Playbooks: KMSAN origins, DMA mapping checks, per-task fault injection, conditional trace capture, and RCU stall comparison (recipes, RCU)
• 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 debugging heuristics
│   ├── evidence-first-workflow.md # Evidence gates, routing, verification, report template
│   ├── case-studies.md         # Real-world debugging examples
│   ├── debug-tools-guide.md    # KASAN, Kprobes, Kmemleak guide
│   └── vmcore-format.md        # vmcore file format details
└── .github/                    # CI & Issue templates
    ├── ISSUE_TEMPLATE/
    └── workflows/release.yml

Usage

This skill triggers when you mention:

• kernel crash / kernel panic
• vmcore analysis
• crash utility
• kernel oops debugging

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

• Report bugs or request features via Issues
• Submit improvements via Pull Requests

Resources

• Crash Utility Whitepaper
• Crash Utility Documentation
• Crash Help Pages

Acknowledgements

The code repository .agents/rules is derived from awesome-claude-code-toolkit.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with passion for kernel debugging