← ClaudeAtlas

retrodisasmlisted

Disassemble retro ROMs (NES, CHIP-8) into bit-perfect reassemblable assembly with retrodisasm. Use when the user wants to disassemble a ROM, reverse-engineer NES code, inspect ROM internals, batch-process ROMs, verify reassembly, or convert binaries to assembly source.
Yuki001/nes-skills · ★ 0 · Data & Documents · score 62
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