retrodisasmlisted
Install: claude install-skill Yuki001/nes-skills
# retrodisasm
retrodisasm is a tracing disassembler for NES and CHIP-8 ROMs. It traces execution flow to distinguish code from data, producing assembly that reassembles to a bit-identical binary.
## Binary Resolution
This skill ships prebuilt binaries in `tools/`:
| Platform | Path |
|----------|------|
| Windows | `{skill_dir}/tools/win/retrodisasm.exe` |
| macOS | `{skill_dir}/tools/macos/retrodisasm` |
| Linux | `{skill_dir}/tools/linux/retrodisasm` |
**Always prefer the bundled binary.** Resolve the platform automatically (`uname -s` → `MINGW*`/`MSYS*` = win, `Darwin` = macos, `Linux` = linux) and use the corresponding path. The command examples below use `retrodisasm` as a placeholder — substitute with the actual binary path.
If the bundled binary is missing or unsuitable for the current platform:
```bash
# Option A: download latest prebuilt release from GitHub
# https://github.com/retroenv/retrodisasm/releases
# -> extract into {skill_dir}/tools/<platform>/
# Option B: install via Go
go install github.com/retroenv/retrodisasm@latest
```
## Quick Start
```bash
# Basic disassembly (auto-detects NES from .nes extension)
retrodisasm -o output.asm game.nes
# Explicit system and assembler
retrodisasm -s nes -a ca65 -o output.asm game.nes
# Output to stdout
retrodisasm -o - game.nes
# Verify output reassembles to identical binary
retrodisasm -o output.asm game.nes -verify
```
If `-o` is omitted, output defaults to `<input>.asm`.
## Supported Systems and Assem