Jakeschincariol/console-skill

Overview

This is a pack of 11 Claude skills plus standard-library Python tools for porting PlayStation 2 games you own to PC via static recompilation. It is not an emulator: the heavy lifting is done by PS2Recomp, which translates the game's MIPS machine code into C++ and compiles it into a native program. The pack builds on the earlier ps2-recomp-Agent-SKILL and splits the workflow into focused jobs — reverse engineering, backend, graphics, sound, controller, levels, physics, saves, mods, packaging and playtesting — so each skill loads only the context its job needs.

It suits people who are comfortable with Ghidra, C++ builds and long debugging sessions. The README is explicit that getting a game from "it compiles" to "it plays" can take weeks, and that PS2Recomp is experimental: many games do not boot yet, graphics and vector-unit code are slow, and large parts of the console remain stubs.

Quick start

Prerequisites: a PS2 game you own and a DVD drive to dump it, a cloned and built PS2Recomp (CMake 3.20+, a C++20 compiler), Ghidra with the EmotionEngine Reloaded extension for retail games, and optionally PCSX2 plus the MCP bridges for Ghidra and PCSX2. Python 3.8+ is required with nothing to pip install.

Install the skills into Claude Code either as a plugin:

/plugin marketplace add Jakeschincariol/console-skill
/plugin install console-skill@console-skill

or copy the folders for plain, unnamespaced commands:

git clone https://github.com/Jakeschincariol/console-skill.git
cp -r console-skill/console-* ~/.claude/skills/

Then start with /console-reverse: it dumps the disc image, reads SYSTEM.CNF to locate the boot ELF, fingerprints it, maps functions in Ghidra, writes the PS2Recomp config, recompiles and builds, and records progress in console/STATE.md. The typical loop is /console-reverse → /console-backend ↔ /console-tester until the port boots and plays, followed by the graphics, sound, controller, physics and level skills, then /console-mod, /console-saves and /console-anywhere. The tools can also be run directly, for example:

python3 console-reverse/iso.py boot game.iso
python3 console-tester/run.py boot --runner out/build/ps2xRuntime/ps2EntryRunner --elf console/disc/SLUS_203.12
python3 console-graphics/tim2.py topng console/disc/DATA --out console/textures/png

Every tool supports --help, most support --json, and they share exit codes 0/1/2. Tests run offline against synthetic fixtures with python3 -m unittest discover -s tests -v.

Constraints

• Bring your own game. The skills only work from a disc you own, dumped on your own machine; they will not help find ISOs, ELFs or BIOS files, and PS2Recomp does not need a BIOS.
• Nothing from the game is published. Disc images, ELFs, textures, audio, level data and the recompiled C++ stay local. Only patches, overrides and your own original assets should be shared, and /console-anywhere refuses to package game files.
• Experimental output. PS2Recomp is under active development; some games will not make it, and a clean rebuild of a large game can take hours.
• Platforms. Building works on Windows, macOS (including Apple silicon) and Linux; PS2Recomp also targets Android and PS Vita. Saves are copied, never moved, and conflicting cloud syncs keep both copies.
• Licensing. The pack itself is MIT, while PS2Recomp is GPL-3.0 and not bundled.

HotRepo's take

There is no HotRepo ranking or snapshot history for this repository yet, and no Hacker News discussion is available, so this assessment rests on the README and repository facts. The design is notably concrete: 11 scoped skills instead of one large prompt, a shared state and design document for multi-session work, and real Python tooling (ISO/ELF inspection, log triage, texture and audio conversion, pnach conversion, packaging guard) with 559 offline tests. The scope is also honestly bounded — the README does not claim instant ports and points users at PS2Recomp's own experimental status. That makes it a practical workflow aid for an already difficult reverse-engineering task rather than a promised one-click solution.