console-skill README

项目的 README,来自 github.com/Jakeschincariol/console-skill。合并为一个 markdown 文件:README.md。

The Console skill

11 Claude skills that port PlayStation 2 games you own to PC: reverse engineer the code, rebuild the graphics and backend, any controller, play it anywhere, then mod it however you want.

Free, MIT, no signup, no API key. The tools are plain Python with nothing to install. The heavy lifting is done by PS2Recomp, ran-j's open-source static recompiler, and the method started life as hkmodd/ps2-recomp-Agent-SKILL.

This is not an emulator. PS2Recomp translates a game's MIPS machine code into C++ and compiles it into a native program for your computer. Getting a game from "it compiles" to "it plays" is weeks of reverse engineering: reading crash logs, finding functions in Ghidra, writing the missing pieces of the console in C++. That grind is what these skills do with you.

One reverse engineers the game and drives the whole port. One builds the backend the game runs on. One rebuilds the graphics, one the sound, one hooks it up to any controller, and one ships it to your laptop, your Steam Deck and your phone. And the craziest one is the Mod skill: describe a change in plain English, a new camo, a faster car, a widescreen camera, and Claude builds it into the game as code that never touches the original files.

Bring your own game. Everything here starts from a disc you own, dumped on your own computer. No ISOs, no BIOS, no downloads, and nothing from the game ever goes into a repo or a mod you share. See the fine print.

Install

Paste this into Claude:

https://github.com/Jakeschincariol/console-skill

install skill

Or as a plugin, in Claude Code:

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

Claude Code namespaces plugin skills, so installed as a plugin they show up as /console-skill:console-reverse and so on. Copy the folders instead if you want plain /console-reverse:

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

The tools need Python 3.8 or newer. Nothing to pip install.

What you need

what why
A PlayStation 2 game you own, and a computer DVD drive dump your own disc to an ISO. /console-reverse shows you how
PS2Recomp, cloned and built the recompiler and the runtime the port runs on (CMake 3.20+, a C++20 compiler)
Ghidra with the EmotionEngine Reloaded extension maps every function in the game. Recommended for any retail game
PCSX2 (optional) test patches before you bake them in, and compare the real game against your port
GhydraMCP and PCSX2-MCP (optional) let Claude drive Ghidra and the PCSX2 debugger itself

Windows, macOS (Apple silicon too) and Linux all work for building. PS2Recomp also has Android and PS Vita targets.

The eleven

command job what it does
/console-reverse Reverse Engineer Opens your own disc image, finds the game's code and maps how it works: the boot ELF, every function, the design doc. Drives the whole port.
/console-backend Backend Engineer Builds the engine room the recompiled game runs on: syscalls, kernel stubs, file and disc I/O, the IOP.
/console-graphics Graphics Artist Rebuilds the graphics: dumps every texture, lets you repaint or replace them with your own art, finds the widescreen fix.
/console-controller Controller Mapper Hooks the game up to any controller: DualSense, Xbox, Switch Pro, keyboard or touch, remapped how you like.
/console-mod Mod Maker Describe any change in plain English and Claude builds it into the game: patches, cheats, new behaviour, as code that never touches the original files.
/console-levels Level Designer Maps the disc's data files, unpacks the archives the levels live in, and swaps in your edits.
/console-sound Sound Designer Rips the music and sound effects and puts your own tracks back in.
/console-physics Physics Tuner Finds the numbers that decide how the game moves (speed, gravity, grip, jump height, frame rate) and tunes them.
/console-saves Save Manager Brings your old memory card saves over, backs them up and syncs them to the cloud so you continue on any device.
/console-anywhere Play Anywhere Builds the port for Windows, Mac, Linux, Steam Deck, Android and PS Vita and packages it without any game files inside.
/console-tester Playtester Runs the port again and again, reads every crash, ranks what to fix next and checks nothing broke.

How to use it

Start with /console-reverse. It sets up console/STATE.md, the port's memory: where everything lives, which phase you are in, every crash and fix so far. Every skill reads it and writes back to it, so you can stop on Monday and pick up on Thursday in a new chat.

reverse -> backend <-> tester               (until it boots, then until it plays)
graphics / sound / controller / physics / levels      (make it yours)
mod                                          (ship your changes as patches)
saves -> anywhere                            (play it everywhere)
  1. /console-reverse: dump your disc, read SYSTEM.CNF to find the boot ELF, pull it out, fingerprint it (serial, region, both CRCs), map it in Ghidra, write the PS2Recomp config, recompile, build. It also writes console/design.md: how the game plays, its menus and its files.
  2. /console-tester boots the port with a hard timeout and reads the log. /console-backend turns every "unimplemented stub" and "syscall TODO" into a ranked fix list and implements them in the runtime. Repeat. This loop is most of the work.
  3. /console-controller writes your button layout into the runtime's pad code. /console-graphics and /console-sound dump textures and audio so you can replace them with your own. /console-physics finds the numbers behind speed, gravity and frame rate.
  4. /console-mod turns a plain-English change, or a PCSX2 .pnach patch you already use, into instruction patches and a game override module.
  5. /console-saves brings your PCSX2 or real memory card saves over. /console-anywhere builds and packages the port for each device, with a guard that refuses to package anything from the game.

The tools

All standard-library Python, run from the repo (or from ~/.claude/skills/). Everything lands in a console/ folder in your game workspace.

python3 console-reverse/iso.py boot game.iso                          # boot ELF, serial, region
python3 console-reverse/iso.py extract game.iso --out console/disc    # the port's cdrom0: root
python3 console-reverse/elf.py info console/disc/SLUS_203.12          # segments, both CRCs, IRX modules
python3 console-reverse/elf.py toml console/disc/SLUS_203.12 --ghidra-csv console/functions.csv
python3 console-reverse/state.py init --game "My Game"                # console/STATE.md
python3 console-tester/run.py boot --runner out/build/ps2xRuntime/ps2EntryRunner --elf console/disc/SLUS_203.12
python3 console-tester/triage.py scan console/runs/latest.log --map console/functions.csv
python3 console-backend/stubs.py scan console/runs/latest.log --repo ../PS2Recomp
python3 console-controller/padmap.py init --layout xbox && python3 console-controller/padmap.py gen
python3 console-graphics/tim2.py topng console/disc/DATA --out console/textures/png
python3 console-graphics/widescreen.py scan console/disc/SLUS_203.12 --out console/patches/widescreen-try.pnach
python3 console-graphics/gspacket.py dma console/dumps/ram.bin --tag 0x01F2A000
python3 console-sound/vag.py towav console/disc/SOUND/BGM01.VAG
python3 console-sound/vag.py fromwav my_song.wav --like console/disc/SOUND/BGM01.VAG --out console/audio/BGM01.VAG
python3 console-levels/datascan.py scan console/disc/ --sort size --embedded
python3 console-physics/tune.py scan console/disc/SLUS_203.12 --value 9.8
python3 console-mod/pnach.py classify my.pnach --elf console/disc/SLUS_203.12
python3 console-mod/override.py new --name "Gold rifle" --elf console/disc/SLUS_203.12 --wrap 0x00123450=gold_damage
python3 console-saves/memcard.py export Mcd001.ps2 --to console/disc/mc0
python3 console-saves/memcard.py sync console/disc/mc0 --cloud ~/Dropbox/console-saves/SLUS-20312
python3 console-anywhere/targets.py doctor --target steamdeck
python3 console-anywhere/targets.py package --runner out/release/ps2xRuntime/ps2EntryRunner --target linux --out console/dist/mygame-linux

Every tool has --help, most have --json, and they share exit codes: 0 ok, 1 something needs your attention, 2 bad input.

python3 -m unittest discover -s tests -v

The tests run offline on fixtures built in code: tiny synthetic ELFs, disc images, textures, audio, memory cards and logs. No game data, BIOS or Sony file is in this repo, and a test fails if one ever is.

What is new since the base skill

hkmodd/ps2-recomp-Agent-SKILL is one big behavioural skill for PS2Recomp: a boot sequence, hard prohibitions, a build gate, a three-strike circuit breaker and a persistent state file. All of that is kept. This pack adds:

Fine print

Bring your own game. Only port games you own, dumped from your own disc on your own drive. Never download ISOs, ELFs or BIOS files; PS2Recomp does not need a BIOS. The skills will not help find any of them.

Nothing from the game gets published. The disc image, the ELF, the IRX modules, textures, audio, level files and the recompiled C++ (it is generated from the game's code) stay on your machine. Share patches, overrides and your own original assets only. /console-anywhere refuses to package game files.

It is experimental. PS2Recomp is under active development and says so: many games do not boot yet, graphics and vector-unit code are slow, and big parts of the console are still stubs. Some games will take weeks. Some will not make it. These skills make the work faster and more methodical; they do not make it instant.

Back up first. Saves are copied, never moved, and every sync keeps both copies when there is a conflict. Builds are incremental only: a clean rebuild of a large game can take hours.

Not affiliated with Sony. PlayStation and PS2 are trademarks of Sony Interactive Entertainment Inc. This project is not affiliated with, endorsed or sponsored by Sony, by ran-j or by hkmodd.

Credits

License notice for hkmodd/ps2-recomp-Agent-SKILL

The porting workflow, guard rails, phases and debugging protocol in console-reverse, console-backend and console-tester are adapted from ps2-recomp-Agent-SKILL, used under its MIT License, reproduced here as published:

MIT License

Copyright (c) 2026 [Your Name / Alias]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

console-skill (Jakeschincariol/console-skill)

正在搜索数据库…

这是什么?这是一组包含 11 个 Claude Agent Skills 的技能,用于指导你将自己拥有的 PlayStation 2 游戏移植到原生 PC 上。方法是通过逆向工程游戏代码,并围绕静态重编译器重建其图形、后端、控制和声音部分。
这是模拟器吗?不是。它调用 PS2Recomp(一个静态重编译器),把游戏的 MIPS 机器码翻译成 C++,再编译成可在你电脑上直接运行的原生程序,而不是在运行时模拟主机。
除了 Claude,我还需要什么工具?Python 3.8+(无需通过 pip install 安装任何包)、一份你自己从光盘导出为 ISO 的 PS2 游戏、用 CMake 3.20+ 和支持 C++20 的编译器构建的 PS2Recomp,以及安装了 EmotionEngine Reloaded 扩展的 Ghidra,用来映射游戏的函数;PCSX2 可选,用于测试。
装上就能让游戏跑起来吗?不能。它明确处于实验阶段:PS2Recomp 仍在积极开发中,许多游戏还无法启动,图形和矢量单元代码运行缓慢,主机的大量部分仍是占位桩代码,因此有些移植需要数周,有些则永远无法完成。
移植版可以构建并发布到哪些平台?构建过程支持 Windows、macOS(包括 Apple Silicon)和 Linux;移植完成后,成品可以面向 Windows、Mac、Linux、Steam Deck、Android 和 PS Vita 发布。
我导出的游戏数据会去哪里?不会传到你的电脑之外:光盘镜像、ELF、IRX 模块、纹理、音频、关卡文件和生成的 C++ 代码都只保存在本地,只有补丁、覆盖文件和你自己的原创资源可以分享;打包技能会拒绝发布任何游戏文件。
授权方面有没有什么坑?技能本身采用 MIT 许可,但它们所驱动的实际重编译器 ran-j/PS2Recomp 采用 GPL-3.0 许可,且未包含在本仓库中,你需要自行克隆并单独构建。
这十一个技能简单来说都有哪些?它们涵盖逆向工程、后端/运行时、图形、手柄按键映射、模组制作、关卡设计、声音、物理参数调校、存档管理、跨平台打包和自动化试玩测试,每个都以斜杠命令的形式运行,例如 /console-reverse 或 /console-mod。
Mod 技能能让我做什么?你可以用通俗的语言描述一项改动,比如新的迷彩、更快的赛车、宽屏镜头,Claude 会把它做成代码加入游戏,且从不改动游戏原始文件。
移植进度如何在多次会话之间保存?第一个技能 /console-reverse 会创建 console/STATE.md 和 console/design.md,其他每个技能都会读取并更新这两个文件,因此你可以中途停下,几天后在新的对话中接着做。
这是索尼或 PS2Recomp 的官方项目吗?不是。它与索尼、ran-j 或 hkmodd 均无关联,也未获得其认可或赞助;它基于 MIT 许可的 hkmodd/ps2-recomp-Agent-SKILL,以及另行授权的 ran-j/PS2Recomp 重编译器构建。
大小
0.4 MB
星标
412
更新
提交Oct 22
时长
27天
提交 · 90 天