Skip to content
Back to search

console-skill

MarketplaceWorks with Claude CodeGitHub

The Console skill pack for Claude: port PlayStation 2 games you own to PC, then mod them

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jakeschincariol--console-skill/badge.svg)](/listings/jakeschincariol--console-skill)

HTML

<a href="/listings/jakeschincariol--console-skill"><img src="/api/listings/jakeschincariol--console-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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 was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "console-skill",
  4. "description": "The Console skill pack for Claude: port PlayStation 2 games you own to PC, then mod them",
  5. "owner": {
  6. "name": "Jake Schincariol",
  7. "url": "https://opusjake.ai"
  8. },
  9. "plugins": [
  10. {
  11. "name": "console-skill",
  12. "description": "Eleven Claude skills for porting PlayStation 2 games you own to native PC with PS2Recomp: a reverse engineer, a backend engineer, a graphics artist, a controller mapper, a mod maker, a level designer, a sound designer, a physics tuner, a save manager, a play-anywhere packager and a playtester.",
  13. "source": "./",
  14. "category": "development",
  15. "homepage": "https://github.com/Jakeschincariol/console-skill"
  16. }
  17. ]
  18. }
README.md · README · 252 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # The Console skill
  2. 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.
  3. Free, MIT, no signup, no API key. The tools are plain Python with nothing to
  4. install. The heavy lifting is done by [PS2Recomp](https://github.com/ran-j/PS2Recomp),
  5. ran-j's open-source static recompiler, and the method started life as
  6. [hkmodd/ps2-recomp-Agent-SKILL](https://github.com/hkmodd/ps2-recomp-Agent-SKILL).
  7. This is not an emulator. PS2Recomp translates a game's MIPS machine code into
  8. C++ and compiles it into a native program for your computer. Getting a game
  9. from "it compiles" to "it plays" is weeks of reverse engineering: reading
  10. crash logs, finding functions in Ghidra, writing the missing pieces of the
  11. console in C++. That grind is what these skills do with you.
  12. One reverse engineers the game and drives the whole port. One builds the
  13. backend the game runs on. One rebuilds the graphics, one the sound, one hooks
  14. it up to any controller, and one ships it to your laptop, your Steam Deck and
  15. your phone. And the craziest one is the Mod skill: describe a change in plain
  16. English, a new camo, a faster car, a widescreen camera, and Claude builds it
  17. into the game as code that never touches the original files.
  18. > **Bring your own game.** Everything here starts from a disc you own, dumped
  19. > on your own computer. No ISOs, no BIOS, no downloads, and nothing from the
  20. > game ever goes into a repo or a mod you share. See the fine print.
  21. ## Install
  22. Paste this into Claude:
  23. ```
  24. https://github.com/Jakeschincariol/console-skill
  25. install skill
  26. ```
  27. Or as a plugin, in Claude Code:
  28. ```
  29. /plugin marketplace add Jakeschincariol/console-skill
  30. /plugin install console-skill@console-skill
  31. ```
  32. Claude Code namespaces plugin skills, so installed as a plugin they show up as
  33. `/console-skill:console-reverse` and so on. Copy the folders instead if you
  34. want plain `/console-reverse`:
  35. ```bash
  36. git clone https://github.com/Jakeschincariol/console-skill.git
  37. cp -r console-skill/console-* ~/.claude/skills/
  38. ```
  39. The tools need Python 3.8 or newer. Nothing to pip install.
  40. ## What you need
  41. | what | why |
  42. | --- | --- |
  43. | A PlayStation 2 game you own, and a computer DVD drive | dump your own disc to an ISO. `/console-reverse` shows you how |
  44. | [PS2Recomp](https://github.com/ran-j/PS2Recomp), cloned and built | the recompiler and the runtime the port runs on (CMake 3.20+, a C++20 compiler) |
  45. | [Ghidra](https://github.com/NationalSecurityAgency/ghidra) with the [EmotionEngine Reloaded](https://github.com/chaoticgd/ghidra-emotionengine-reloaded) extension | maps every function in the game. Recommended for any retail game |
  46. | [PCSX2](https://pcsx2.net) (optional) | test patches before you bake them in, and compare the real game against your port |
  47. | [GhydraMCP](https://github.com/starsong-consulting/GhydraMCP) and [PCSX2-MCP](https://github.com/hkmodd/PCSX2-MCP) (optional) | let Claude drive Ghidra and the PCSX2 debugger itself |
  48. Windows, macOS (Apple silicon too) and Linux all work for building. PS2Recomp
  49. also has Android and PS Vita targets.
  50. ## The eleven
  51. | command | job | what it does |
  52. | --- | --- | --- |
  53. | `/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. |
  54. | `/console-backend` | Backend Engineer | Builds the engine room the recompiled game runs on: syscalls, kernel stubs, file and disc I/O, the IOP. |
  55. | `/console-graphics` | Graphics Artist | Rebuilds the graphics: dumps every texture, lets you repaint or replace them with your own art, finds the widescreen fix. |
  56. | `/console-controller` | Controller Mapper | Hooks the game up to any controller: DualSense, Xbox, Switch Pro, keyboard or touch, remapped how you like. |
  57. | `/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. |
  58. | `/console-levels` | Level Designer | Maps the disc's data files, unpacks the archives the levels live in, and swaps in your edits. |
  59. | `/console-sound` | Sound Designer | Rips the music and sound effects and puts your own tracks back in. |
  60. | `/console-physics` | Physics Tuner | Finds the numbers that decide how the game moves (speed, gravity, grip, jump height, frame rate) and tunes them. |
  61. | `/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. |
  62. | `/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. |
  63. | `/console-tester` | Playtester | Runs the port again and again, reads every crash, ranks what to fix next and checks nothing broke. |
  64. ## How to use it
  65. Start with `/console-reverse`. It sets up `console/STATE.md`, the port's
  66. memory: where everything lives, which phase you are in, every crash and fix so
  67. far. Every skill reads it and writes back to it, so you can stop on Monday and
  68. pick up on Thursday in a new chat.
  69. ```
  70. reverse -> backend <-> tester (until it boots, then until it plays)
  71. graphics / sound / controller / physics / levels (make it yours)
  72. mod (ship your changes as patches)
  73. saves -> anywhere (play it everywhere)
  74. ```
  75. 1. **`/console-reverse`**: dump your disc, read `SYSTEM.CNF` to find the boot
  76. ELF, pull it out, fingerprint it (serial, region, both CRCs), map it in
  77. Ghidra, write the PS2Recomp config, recompile, build. It also writes
  78. `console/design.md`: how the game plays, its menus and its files.
  79. 2. **`/console-tester`** boots the port with a hard timeout and reads the log.
  80. **`/console-backend`** turns every "unimplemented stub" and "syscall TODO"
  81. into a ranked fix list and implements them in the runtime. Repeat. This
  82. loop is most of the work.
  83. 3. **`/console-controller`** writes your button layout into the runtime's pad
  84. code. **`/console-graphics`** and **`/console-sound`** dump textures and
  85. audio so you can replace them with your own. **`/console-physics`** finds
  86. the numbers behind speed, gravity and frame rate.
  87. 4. **`/console-mod`** turns a plain-English change, or a PCSX2 `.pnach` patch
  88. you already use, into instruction patches and a game override module.
  89. 5. **`/console-saves`** brings your PCSX2 or real memory card saves over.
  90. **`/console-anywhere`** builds and packages the port for each device,
  91. with a guard that refuses to package anything from the game.
  92. ## The tools
  93. All standard-library Python, run from the repo (or from `~/.claude/skills/`).
  94. Everything lands in a `console/` folder in your game workspace.
  95. ```bash
  96. python3 console-reverse/iso.py boot game.iso # boot ELF, serial, region
  97. python3 console-reverse/iso.py extract game.iso --out console/disc # the port's cdrom0: root
  98. python3 console-reverse/elf.py info console/disc/SLUS_203.12 # segments, both CRCs, IRX modules
  99. python3 console-reverse/elf.py toml console/disc/SLUS_203.12 --ghidra-csv console/functions.csv
  100. python3 console-reverse/state.py init --game "My Game" # console/STATE.md
  101. python3 console-tester/run.py boot --runner out/build/ps2xRuntime/ps2EntryRunner --elf console/disc/SLUS_203.12
  102. python3 console-tester/triage.py scan console/runs/latest.log --map console/functions.csv
  103. python3 console-backend/stubs.py scan console/runs/latest.log --repo ../PS2Recomp
  104. python3 console-controller/padmap.py init --layout xbox && python3 console-controller/padmap.py gen
  105. python3 console-graphics/tim2.py topng console/disc/DATA --out console/textures/png
  106. python3 console-graphics/widescreen.py scan console/disc/SLUS_203.12 --out console/patches/widescreen-try.pnach
  107. python3 console-graphics/gspacket.py dma console/dumps/ram.bin --tag 0x01F2A000
  108. python3 console-sound/vag.py towav console/disc/SOUND/BGM01.VAG
  109. python3 console-sound/vag.py fromwav my_song.wav --like console/disc/SOUND/BGM01.VAG --out console/audio/BGM01.VAG
  110. python3 console-levels/datascan.py scan console/disc/ --sort size --embedded
  111. python3 console-physics/tune.py scan console/disc/SLUS_203.12 --value 9.8
  112. python3 console-mod/pnach.py classify my.pnach --elf console/disc/SLUS_203.12
  113. python3 console-mod/override.py new --name "Gold rifle" --elf console/disc/SLUS_203.12 --wrap 0x00123450=gold_damage
  114. python3 console-saves/memcard.py export Mcd001.ps2 --to console/disc/mc0
  115. python3 console-saves/memcard.py sync console/disc/mc0 --cloud ~/Dropbox/console-saves/SLUS-20312
  116. python3 console-anywhere/targets.py doctor --target steamdeck
  117. python3 console-anywhere/targets.py package --runner out/release/ps2xRuntime/ps2EntryRunner --target linux --out console/dist/mygame-linux
  118. ```
  119. Every tool has `--help`, most have `--json`, and they share exit codes: 0 ok,
  120. 1 something needs your attention, 2 bad input.
  121. ```bash
  122. python3 -m unittest discover -s tests -v
  123. ```
  124. The tests run offline on fixtures built in code: tiny synthetic ELFs, disc
  125. images, textures, audio, memory cards and logs. No game data, BIOS or Sony
  126. file is in this repo, and a test fails if one ever is.
  127. ## What is new since the base skill
  128. [hkmodd/ps2-recomp-Agent-SKILL](https://github.com/hkmodd/ps2-recomp-Agent-SKILL)
  129. is one big behavioural skill for PS2Recomp: a boot sequence, hard prohibitions,
  130. a build gate, a three-strike circuit breaker and a persistent state file. All of
  131. that is kept. This pack adds:
  132. - **Eleven jobs instead of one prompt.** Each skill loads only what its job
  133. needs, so the context stays small on a port that lasts weeks.
  134. - **Real tools, not just rules.** An ISO 9660 reader, an ELF inspector that
  135. prints both CRCs (the runtime's CRC-32 and PCSX2's pnach CRC), a log triage
  136. that ranks crashes and maps them to Ghidra function names, a boot and soak
  137. runner with hard timeouts, a pnach-to-PS2Recomp converter, a game override
  138. generator, a float and frame-rate constant finder, a TIM2 texture
  139. converter, a widescreen candidate finder, a DMA/VIF/GIF packet walker, a VAG
  140. audio decoder and encoder, a data archive mapper, a memory card reader with
  141. safe cloud sync, a controller code generator with input replay, and a
  142. packager that refuses to ship game files. 559 offline tests.
  143. - **Every platform.** The base skill was Windows only (vcvars64, PowerShell,
  144. `.bat`). This pack covers Windows, macOS, Linux, Steam Deck, Android and
  145. PS Vita.
  146. - **Up to date with PS2Recomp.** Checked against PS2Recomp as of October 2026:
  147. the Ghidra export workflow, the real runtime file layout, the real game
  148. override API (the base skill's override template calls functions that do
  149. not exist), and the exact log lines the runtime prints.
  150. - **A design doc and a state file every skill shares**, kept in
  151. `console/STATE.md` and `console/design.md`.
  152. ## Fine print
  153. **Bring your own game.** Only port games you own, dumped from your own disc on
  154. your own drive. Never download ISOs, ELFs or BIOS files; PS2Recomp does not
  155. need a BIOS. The skills will not help find any of them.
  156. **Nothing from the game gets published.** The disc image, the ELF, the IRX
  157. modules, textures, audio, level files and the recompiled C++ (it is generated
  158. from the game's code) stay on your machine. Share patches, overrides and your
  159. own original assets only. `/console-anywhere` refuses to package game files.
  160. **It is experimental.** PS2Recomp is under active development and says so:
  161. many games do not boot yet, graphics and vector-unit code are slow, and big
  162. parts of the console are still stubs. Some games will take weeks. Some will not
  163. make it. These skills make the work faster and more methodical; they do not
  164. make it instant.
  165. **Back up first.** Saves are copied, never moved, and every sync keeps both
  166. copies when there is a conflict. Builds are incremental only: a clean rebuild
  167. of a large game can take hours.
  168. **Not affiliated with Sony.** PlayStation and PS2 are trademarks of Sony
  169. Interactive Entertainment Inc. This project is not affiliated with, endorsed
  170. or sponsored by Sony, by ran-j or by hkmodd.
  171. ## Credits
  172. - [hkmodd/ps2-recomp-Agent-SKILL](https://github.com/hkmodd/ps2-recomp-Agent-SKILL)
  173. (MIT): the original PS2Recomp agent skill this pack is built on. Its license
  174. notice is reproduced below.
  175. - [ran-j/PS2Recomp](https://github.com/ran-j/PS2Recomp) (GPL-3.0): the static
  176. recompiler and runtime. Not included here.
  177. - [ps2tek](https://psi-rockin.github.io/ps2tek/) by PSI: the PS2 hardware
  178. reference the skills point to.
  179. <details>
  180. <summary>License notice for hkmodd/ps2-recomp-Agent-SKILL</summary>
  181. The porting workflow, guard rails, phases and debugging protocol in
  182. `console-reverse`, `console-backend` and `console-tester` are adapted from
  183. ps2-recomp-Agent-SKILL, used under its MIT License, reproduced here as
  184. published:
  185. ```
  186. MIT License
  187. Copyright (c) 2026 [Your Name / Alias]
  188. Permission is hereby granted, free of charge, to any person obtaining a copy
  189. of this software and associated documentation files (the "Software"), to deal
  190. in the Software without restriction, including without limitation the rights
  191. to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  192. copies of the Software, and to permit persons to whom the Software is
  193. furnished to do so, subject to the following conditions:
  194. The above copyright notice and this permission notice shall be included in all
  195. copies or substantial portions of the Software.
  196. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  197. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  198. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  199. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  200. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  201. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  202. SOFTWARE.
  203. ```
  204. </details>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.