Install
https://github.com/Jakeschincariol/console-skill누구에게 맞는지
내가 직접 산 PS2 디스크가 있고, 내 컴퓨터에서 디스크 이미지로 이미지징한 뒤 그 개인 사본을 PC로 옮겨 계속 플레이하고 계속 개조하고 싶은 사람입니다. 이 저장소가 주는 것은 포팅 작업 하나를 하나씩 호출할 수 있는 단계로 쪼갠 11개의 Claude 스킬입니다. 실제로 손을 움직이는 건 대화 중인 Claude이고, 저장소 자체가 더블클릭으로 실행되는 완성된 포팅을 만들어 주지는 않습니다.
명시적으로 대상에서 빠지는 또 다른 유형이 있습니다. 여기에는 내려받을 수 있는 ISO도, BIOS도, 출처가 불분명한 소재도 없습니다. 모든 것이 내가 소유한 디스크에서 시작하므로 "먼저 소스를 찾자"는 경로는 여기서 통하지 않습니다. 효과만 보고 싶은 사람에게도 맞지 않습니다. 디스크 이미지징, 빌드 환경 준비, 구간별 리버스 판단 — 이 단계들은 모두 내가 떠안아야 합니다. 이미 잘 돌아가고 도구 체인을 만져볼 필요가 전혀 없는 게임을 원하는 분이라면 이 길은 맞지 않습니다. 포팅을 담는 런타임은 내가 직접 준비해야 하고, 스킬이 하는 일은 과정을 쪼개어 설명하는 것뿐입니다.
대략적인 프로필은 명령줄을 다룰 수 있고 컴파일 에러를 읽을 수 있으며, 개인 사본 하나를 위해 리버스에 시간을 쓸 의사가 있는 개인 개발자와 애호가들입니다. 이 디스크를 납품할 제품이 아니라 연구하고 뜯어볼 대상으로 보는 사람들입니다.
3분 만에 첫 시도
공식 설치 방법은 아주 직관적입니다. Claude 대화창에 아래 두 줄을 붙여넣으세요.
https://github.com/Jakeschincariol/console-skill
install skill
붙여넣기 전에 두 가지를 확인하세요. 이미지 파일을 어느 디렉터리에 두었고 현재 세션에서 접근 가능한지, 그리고 이 컴퓨터에 이미 CMake 3.20 이상과 C++20 컴파일러가 있는지.
미리 알아둘 전제가 두 가지 있습니다. 첫째, 스킬 스크립트 자체는 순수 Python이라 설치할 의존성이 없습니다. 붙여넣은 뒤 Claude가 저장소를 읽어 11개 스킬을 준비합니다. 시간이 걸리는 건 실행 단계에 필요한 PS2Recomp 런타임이며, 이는 직접 clone하고 빌드해야 하고 요구 환경은 CMake 3.20 이상과 C++20 컴파일러입니다. 둘째, 전체 체인의 출발점은 직접 이미지징한 디스크 이미지라는 점입니다. 바로 쓸 수 있는 소재는 없습니다.
설치 위치: 스킬이 설치되면 Claude 안에 슬래시 명령으로 나타납니다. Claude Code에서 플러그인 방식으로 설치하면 명령에 네임스페이스가 붙어 /console-skill:console-reverse 형태로 표기됩니다.
첫 실행은 읽기 전용 단계를 고르세요. Claude가 /console-reverse를 호출해 로컬 디스크 이미지를 열고, 부트 ELF를 식별하고, 함수 목록을 뽑아 설계 문서를 만들게 하세요. 이 단계는 이미지를 바꾸지 않고 실행 파일도 만들지 않습니다. 부작용은 한 군데뿐입니다. 분석 산출물(설계 문서와 함수 목록)이 지정한 작업 디렉터리에 남기 때문에 출력 디렉터리를 먼저 확인하고 진행시키고, 이미지가 있는 위치에 쓰게 두지 마세요.
확인 가능한 성공 신호: 명령이 인식되어 끝까지 돌고, 출력에 부트 ELF의 위치, 함수 개수, 설계 문서 경로가 나타납니다.
사용 사례
사례 하나: 내 디스크를 분석 가능한 코드 구조로 바꾸기. /console-reverse는 디스크 이미지를 열어 게임 코드를 찾아내고, 부트 ELF과 모든 함수, 설계 문서를 매핑합니다. 저장소 설명은 이 단계를 포팅 전체를 끌고 가는 단계로 봅니다. 이 단계의 입력은 내 디스크 이미지 하나뿐이고, 출력은 설계 문서와 함수 단위 지도이며, 실행 가능한 프로그램 자체를 만들어내지는 않습니다. 여기까지가 확인 가능한 범위입니다. 이 단계는 설명되어 있지만, 이후 각 단계의 세부 명령과 산출물 목록은 공식 설명에 없습니다. 즉 다음 단계에서 구체적으로 무엇을 할지는 대화에서 계속 물어봐야 합니다.
사례 둘: 재컴파일이 실제로 돌아갈 자리를 준비하기. 저장소는 PS2Recomp를 필수 구성요소로 두고, 재컴파일러이자 포팅이 동작하는 런타임으로 규정하며 직접 clone하고 빌드해야 한다고 합니다. CMake 3.20 이상과 C++20 컴파일러가 필요합니다. 근거는 빌드 요구사항까지입니다. 구체적인 clone 주소와 빌드 명령은 상위 PS2Recomp 저장소 영역이며, 이 저장소의 설명은 이를 반복하지 않습니다.
사용 경계
- 출발점은 내가 소유하고 직접 이미지징한 디스크일 수밖에 없습니다. 여기에는 ISO도, BIOS도, 내려받은 콘텐츠도 없고, 게임 데이터는 내가 공유할 저장소나 Mod에도 들어가지 않습니다.
- PS2Recomp는 곧바로 쓸 수 있는 물건이 아닙니다. 동작하는 C++20 툴체인과 CMake가 필요하고, 빌드 문제도 직접 처리할 준비가 되어 있어야 합니다.
- 드는 것은 스킬과 단계 설명이지 완성된 포팅이 아닙니다. 실행 가능 여부는 이미지 품질, 리버스 판단, 빌드 환경에 달려 있습니다.
- 플러그인 방식 설치는 Claude Code에서만 유효하고 명령에 네임스페이스가 붙습니다. Claude 대화창에 붙여넣는 방식에는 접두사가 없어 두 방식의 명령 이름이 같지 않습니다.
- 공개 설명은 11개 스킬 전체의 역할 분담과 각 단계가 전제하는 조건까지입니다. 특정 스킬 내부의 명령 목록과 인수 기준은 하나씩 펼쳐져 있지 않으니, 실제로 호출할 때 확인해야 합니다.