console-skill: 11 skills de Claude para fazer engenharia reversa do seu próprio disco PS2 e portá-lo para PC

Para quem é

Você tem um disco PS2 que comprou por conta própria e está disposto a transformá-lo em um arquivo de imagem no seu próprio computador, levando depois essa cópia privada para o PC para continuar jogando e continuar modificando. O que o repositório oferece são 11 skills de Claude que quebram uma portabilidade em etapas que podem ser chamadas uma a uma; quem executa o trabalho de fato é o Claude da sua conversa — o repositório não entrega uma portagem final pronta para abrir com dois cliques.

Ele exclui explicitamente outro tipo de pessoa: aqui não há ISO para baixar, nem BIOS, nem material de procedência duvidosa — tudo parte do disco que você mesmo possui, então o caminho de "primeiro procure os recursos" não funciona aqui. Também não serve para quem só quer ver o efeito: gerar a imagem do disco, preparar o ambiente de compilação e tomar as decisões de engenharia reversa trecho a trecho ficam por sua conta. Se o que você quer é um jogo que já roda e em que nunca precisa encostar na cadeia de ferramentas, esse caminho não serve: o ambiente de execução que carrega a portagem precisa ser preparado por você; o que os skills fazem é apenas abrir o processo em etapas e explicá-lo com clareza.

O perfil aproximado: desenvolvedores individuais e entusiastas que sabem usar uma linha de comando, ler erros de compilação e estão dispostos a investir tempo em engenharia reversa por causa de uma cópia privada — gente que vê esse disco como objeto de pesquisa e brincadeira, não como um produto a entregar.

Primeira tentativa em 3 minutos

O método oficial de instalação é bem direto: cole as duas linhas abaixo na sua conversa com o Claude.

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

Antes de colar, confirme duas coisas: em que diretório está o arquivo de imagem e se a sessão atual consegue acessá-lo; e se esta máquina já tem CMake 3.20 ou superior e um compilador C++20.

Há duas premissas que vale conhecer. A primeira: os scripts dos skills são Python puro, sem dependências a instalar; depois de colar, o Claude lê o repositório e prepara os 11 skills; o que realmente leva tempo é o ambiente de execução PS2Recomp exigido pela fase de execução, que você mesmo precisa clonar e compilar, com CMake 3.20+ e um compilador C++20 como requisitos. A segunda: o ponto de partida de toda a cadeia é a imagem de disco que você mesmo gerou — não há material pronto para uso.

Local de instalação: depois de instalado, o skill aparece no Claude como comando com barra; se você o instalar como plugin no Claude Code, o comando ganha um espaço de nomes e passa a ser escrito /console-skill:console-reverse.

Para a primeira execução, escolha o passo somente de leitura: faça o Claude invocar /console-reverse, abrir a sua imagem de disco local, identificar o ELF de inicialização, listar as funções e produzir um documento de projeto. Esse passo não altera sua imagem nem gera um executável. Há um único efeito colateral: os resultados da análise (documento de projeto e lista de funções) ficam no diretório de trabalho que você indicar, então confirme antes o diretório de saída e não deixe que ele escreva onde está a imagem.

Sinais de sucesso observáveis: o comando é reconhecido e roda até o fim, e a saída mostra onde está o ELF de inicialização, quantas funções foram listadas e o caminho de um documento de projeto.

Casos de uso

Caso um: transformar um disco próprio em uma estrutura de código analisável. O /console-reverse abre sua imagem de disco, encontra o código do jogo e mapeia o ELF de inicialização, cada função e um documento de projeto — a documentação do repositório apresenta esse passo como aquele que conduz toda a portagem. A entrada desse passo é apenas a sua própria imagem de disco; a saída é um documento de projeto e um mapa em nível de função, e ele não produz um programa executável por si só. Até aqui chega o que está documentado: esse passo é bem explicado, mas os comandos exatos e as listas de entregáveis das fases seguintes não constam na documentação oficial — ou seja, o que exatamente fazer no próximo passo você precisa continuar perguntando na conversa.

Caso dois: preparar um lugar onde a recompilação realmente rode. O repositório lista o PS2Recomp como componente obrigatório, posicionado como o recompilador e como o ambiente de execução onde a portagem vive, e ele precisa ser clonado e compilado por você, com CMake 3.20+ e um compilador C++20. As evidências chegam até os requisitos de build: o endereço de clonagem e os comandos de build pertencem ao escopo do repositório upstream do PS2Recomp, e a documentação deste repositório não os repete.

Limites de uso

• O ponto de partida só pode ser um disco que você possui e que você mesmo transformou em imagem; aqui não há ISO, nem BIOS, nem conteúdo baixado, e os dados do jogo também não entram em um repositório ou mod que você pretenda compartilhar.
• O PS2Recomp não vem pronto para usar: você precisa de uma cadeia de ferramentas C++20 funcional e de CMake, e de vontade para resolver os problemas de build por conta própria.
• O que você recebe são skills e instruções passo a passo, não uma portagem pronta; se funciona ou não depende da qualidade da imagem, das decisões de engenharia reversa e do ambiente de compilação.
• A instalação como plugin vale só para o Claude Code, e o comando ganha espaço de nomes; instalado por colagem no Claude, não há prefixo — e o nome do comando não é o mesmo nas duas formas.
• A documentação pública mostra a divisão geral do trabalho entre os 11 skills e os pré-requisitos de cada etapa; as listas de comandos e os critérios de aceitação dentro de um skill específico não são detalhadas uma a uma, então é preciso confirmá-las no momento da chamada.