Re Skill

/re — Reverse Engineering Skill for Claude Code

A Claude Code skill that bootstraps and drives retro game reverse-engineering projects. Point it at a ROM or binary, and it scaffolds a full RE workspace — then iteratively disassembles, annotates, extracts assets, and ports the game to a web canvas, all from the CLI.

What it does

• /re path/to/rom.nes — Bootstrap a new RE project: identify the binary, scaffold REVERSE.md + labels.csv + tools/, create first investigation tasks
• /re (no args) — Continue from where you left off: pick the next unchecked task from REVERSE.md and work it
• re_loop.sh — Run autonomous sessions in a loop until all tasks are done, auto-committing after each

Supported platforms

The skill is platform-agnostic. It has been used on:

• NES (6502, iNES format, 2bpp CHR tiles)
• Game Boy (SM83/LR35902, Nintendo logo header)
• DOS MZ (8086/Borland, EGA planar graphics)

Adding a new platform means writing the `tools/instruction_set.py` for that CPU — everything else adapts.

Install

# Clone or copy into your Claude Code skills directory
mkdir -p ~/.claude/skills
cp -r re/ ~/.claude/skills/re/

# Or clone the repo and symlink
git clone https://github.com/USER/re-skill.git
ln -s "$(pwd)/re-skill" ~/.claude/skills/re

After install, `/re` will appear as an available skill in Claude Code.

Prerequisites

• Claude Code CLI (claude command)
• Python 3.8+
• pypng (pip install pypng) — for tile/screen PNG export
• jq — for re_loop.sh stream parsing

What gets scaffolded

your-project/
  REVERSE.md            # Data-range map, findings, task list, verification checklist
  labels.csv            # addr,name,comment — grows as you annotate
  dead_ends.md          # Stuck log — avoids repeating failed approaches
  re_loop.sh            # Autonomous session driver
  re_loop_sessions/     # Session logs
  tools/
    instruction_set.py  # CPU opcode da