# crash-decode

The crash-decode skill for Claude Code decodes pulsar crash reports into source code lines using addr2line and pulsar.debug. Use it when analyzing logs after SIGSEGV.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 125 repo stars
- Author: Morvex885
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Morvex885/pulsar/tree/HEAD/.agents/skills/crash-decode/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/crash-decode

## What it does

The skill parses pc, lr addresses and fp chains from === CRASH reports. It requires the `pulsar.debug` file from the same build or commit as the crashed daemon.

The tool verifies the match via `nm` by checking the `pulsar_crash_handler` address. When versions align, `addr2line` maps log addresses to specific filenames and lines. Mismatched binaries prevent accurate decoding.

It reads logs from `tools/station.sh` or `/tmp/pulsar.log`. If the host `addr2line` fails to recognize the architecture, use `llvm-addr2line`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Morvex885/pulsar --skill crash-decode -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/crash-decode/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/crash-decode/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Morvex885/pulsar --skill crash-decode -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/crash-decode/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Morvex885/pulsar --skill crash-decode -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/crash-decode/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Morvex885/pulsar .agents/skills/crash-decode
```

2. **Manually: put the files in place**
- File: `.github/skills/crash-decode/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Morvex885/pulsar --skill crash-decode -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Morvex885/pulsar --path .agents/skills/crash-decode
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/crash-decode/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Morvex885/pulsar/tree/HEAD/.agents/skills/crash-decode/SKILL.md

## When to use it
- Decode SIGSEGV in pulsar logs
- Map stack addresses to files and lines
- Validate === CRASH report integrity
- Match the correct pulsar.debug file

## Example prompts
- Decode the crash from `/tmp/pulsar.log`
- Show call stack for the === CRASH report in the log

## Similar
- [debug](https://affpapa.org/en/nevibecode/skills/pwguler-debug.md) — skill · 1000 installs
- [sleuth](https://affpapa.org/en/nevibecode/agents/sleuth.md) — subagent · ★ 3951 repo stars
- [asc-crash-triage](https://affpapa.org/en/nevibecode/skills/asc-crash-triage.md) — skill · 6800 installs
- [tldr-code](https://affpapa.org/en/nevibecode/skills/tldr-code.md) — skill · 509 installs
- [MCP Server for WinDbg Crash Analysis](https://affpapa.org/en/nevibecode/mcp/mcp-server-for-windbg-crash-analysis.md) — MCP server · ★ 1676 repo stars
- [jwt-decode](https://affpapa.org/en/nevibecode/skills/jwt-decode.md) — skill · 762 installs

From the same set: [morvex885/pulsar](https://affpapa.org/en/nevibecode/by/morvex885/pulsar.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
