reverse-skill: o roteador de skills que ensina agentes de IA a fazer engenharia reversa e pentest

O repositório reverse-skill, do desenvolvedor zhaoxuya520, passou de projeto pessoal a um dos nomes mais comentados do GitHub em 2026: mais de 33 mil estrelas e 4,4 mil forks desde que foi criado, em maio. A proposta é simples de descrever e incomum na prática: dar a um agente de IA de código (Claude Code, Codex, Cursor, Cline, OpenCode e similares) um roteador de decisão para tarefas de engenharia reversa, análise de malware, pentest e CTF — em vez de deixar o agente "chutar" qual ferramenta usar a cada caso.

O problema que o projeto tenta resolver

Segundo a documentação do próprio repositório, quando um agente de IA encontra um APK, um binário, um JavaScript de frontend ofuscado ou um desafio de CTF, ele geralmente não sabe se deve recorrer ao jadx, ao apktool, ao Frida, ao IDA Pro ou ao Burp Suite — cada tipo de alvo pede um manual de procedimento diferente, e esse conhecimento costuma estar espalhado entre máquinas, scripts pessoais e a memória de quem já fez aquele tipo de análise antes. O resultado é retrabalho: cada equipe que tenta automatizar esse fluxo com um agente acaba resolvendo o mesmo problema de novo.

Como funciona o roteamento

O core do projeto não é um conjunto de prompts soltos, é uma configuração estruturada (skills/config/routing.json) com 43 regras de roteamento (identificadas de R0 a R44), validada por uma suíte de regressão de 173 casos de teste rodando em CI no Windows e no Ubuntu. O fluxo declarado no README é direto:

Tarefa do usuário
  → RULES.md (regras globais)
  → MASTER-ROUTING / master-route.ps1 (ladder principal)
  → case-init / scope.md (autorização + perfil de rede; nenhuma ação antes disso)
  → Skill do cenário → ferramentas / MCP / scripts
  → linha do tempo + Evidência→Achado→Caminho → relatório

Antes de qualquer ação prática, o roteador exige uma etapa de escopo e autorização (scope.md) — o pipeline não deixa o agente agir sobre um alvo sem essa checagem prévia registrada.

O catálogo de cenários

O repositório organiza 44 módulos de skill cobrindo praticamente todo o espectro de segurança ofensiva e engenharia reversa: análise de APK/Android, iOS, binários (exe/dll/so/elf) via IDA ou radare2, .NET/C#, JavaScript de frontend com parâmetros criptografados, VMs de bytecode customizado, malware e YARA, ferramentas de pentest, orquestração de cadeia de ataque red-team, revisão de evidências de caso, firmware/IoT, diff de patch para exploração de N-day, desenvolvimento de exploits (pwn), bypass de EDR, segurança de API/GraphQL, supply chain/SBOM e segurança de LLM. Há ainda um orquestrador dedicado a competições de CTF, com 42 sub-skills próprias.

O projeto se declara neutro em relação ao cliente de IA: o núcleo de roteamento, a suíte de regressão e os manifestos não dependem de nenhum assistente específico — cada cliente carrega o repositório pelo próprio mecanismo de instruções de projeto.

Licenciamento fragmentado, um detalhe que importa

O reverse-skill em si é licenciado sob MIT, mas isso não cobre tudo que o repositório orquestra: o submódulo CTF-Sandbox-Orchestrator é GPLv3, e o projeto invoca externamente um "Pentest Swarm AI" que é AGPL-3.0 sem incluir o código-fonte dele. Isso é um ponto que qualquer equipe que for reaproveitar partes do projeto em um produto comercial precisa mapear antes, caso a caso, para não herdar obrigações de licença sem perceber.

O aviso que acompanha o projeto

A documentação é explícita quanto ao uso: o repositório é apresentado como destinado "exclusivamente a pesquisa de segurança lícita, educação, competições de CTF e testes em sistemas que você possui ou tem autorização explícita para avaliar", com aviso direto de que acesso, varredura ou exploração não autorizados são proibidos e de responsabilidade exclusiva de quem usa a ferramenta. Vale o registro: um roteador que baixa o atrito de configurar um fluxo de pentest também baixa o atrito de quem quiser usá-lo fora desse escopo — o valor real de um projeto como esse depende de continuar sendo tratado como ferramenta de trabalho de equipes autorizadas, e não como atalho genérico.

Por que isso é relevante além do nicho de segurança

Independentemente da área de aplicação, o reverse-skill é um exemplo concreto de um padrão que vem se repetindo em 2026: transformar conhecimento de procedimento (qual ferramenta usar, em que ordem, com que checagens) em uma configuração estruturada e testável que qualquer agente de IA consegue seguir — em vez de depender de um prompt longo e informal. É a mesma lógica por trás de convenções como AGENTS.md e do recém-lançado Open Knowledge Format do Google, aplicada a um domínio onde o custo de um agente "chutar" o próximo passo é mais alto que em quase qualquer outro.