ps2-recomp-Agent-SKILL

Automate the PS2Recomp pipeline for reverse engineering and recompiling PlayStation 2 games.

18|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/hkmodd/ps2-recomp-Agent-SKILL --skill ps2-recomp-agent-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ps2-recomp-Agent-SKILL
Source: https://github.com/hkmodd/ps2-recomp-Agent-SKILL/tree/main
Command: npx skills add https://github.com/hkmodd/ps2-recomp-Agent-SKILL --skill ps2-recomp-agent-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and time-consuming process of reverse engineering and recompiling PlayStation 2 games for PC, tackling everything from initial setup to runtime debugging.

Core Features & Use Cases

  • Full Pipeline Automation: Guides the agent through PS2Recomp's analyzer, recompiler, and C++ runtime stages.
  • Environment Setup: Detects and helps configure the optimal build toolchain (Clang + Ninja).
  • Crash Resolution: Systematically diagnoses and fixes crashes using TOML stubs, runtime C++ fixes, and game overrides.
  • Use Case: Use this Skill to take a PS2 game ISO, extract its executable, recompile it using PS2Recomp, and get it running on PC, handling all the intricate steps and potential roadblocks autonomously.

Quick Start

Use the ps2-recomp-Agent-SKILL to start a new PS2 recompilation session for the game 'Jak and Daxter: The Precursor Legacy' (SCUS-97024), using the ISO located at 'D:/PS2_Games/JakAndDaxter_SCUS97024_USA/SCUS97024.iso'.

Frequently Asked Questions about ps2-recomp-Agent-SKILL

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate PS2 game recompilation from an ISO to a PC executable?

Automate PS2 game recompilation by using an agent to run the PS2Recomp pipeline, extracting the MIPS executable from the ISO, generating C++ code, and compiling it with Clang and Ninja.

What is the best way to set up the Clang and Ninja build toolchain for PS2Recomp?

Setting up the Clang and Ninja toolchain for PS2Recomp is automated by the agent, which detects your environment and helps configure the optimal build system to generate a compiled PC executable.

Why does my PS2 recompiled game crash at runtime, and how do I fix it?

Fix PS2 recompiled game crashes by systematically diagnosing runtime errors using TOML stubs, applying C++ runtime fixes, and implementing game overrides for specific hardware interactions.

Can I recompile PlayStation 2 games with complex graphics pipelines and syscalls?

Yes, you can recompile PlayStation 2 games with complex graphics pipelines and syscalls because the agent systematically addresses common PS2 hardware interactions and runtime debugging issues.

Do I need to manually write TOML configuration files for PS2 reverse engineering?

You do not need to manually write TOML configuration files for PS2 reverse engineering, as the agent autonomously manages binary analysis and TOML configuration generation throughout the pipeline.

What are the limitations when using PS2Recomp for game porting?

Limitations of using PS2Recomp for game porting include potential unresolved PS2 hardware interactions or unimplemented syscalls, which require manual C++ runtime fixes and TOML stubs to bypass crashes.