Pacchetto router di competenze basato sull'IA per reverse engineering, penetration testing e ricerca sulla sicurezza. Instrada gli agenti IA verso le metodologie corrette e avvia toolchain on-demand per attività su APK, binary, JS, firmware e CTF.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/8814/abab1a33f37d5940076470ea863d219a7b57df6e3b0f42f087ed1581b499c345.png" alt="reverse-skill" width="140" />
</p>
<h1 align="center">reverse-skill</h1>
<h3 align="center">Router di competenze per la cybersecurity · Pacchetto di instradamento delle competenze di reverse engineering</h3>
<p align="center"><em style="font-family: Georgia, serif; font-size: 1.2em; color: #777;">Solca le acque oscure, naviga controcorrente.</em></p>
<p align="center">
<a href="https://github.com/zhaoxuya520/reverse-skill/releases"><img src="https://img.shields.io/badge/release-v1.0.1-blue" alt="release v1.0.1"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/stargazers"><img src="https://img.shields.io/github/stars/zhaoxuya520/reverse-skill?style=flat&logo=github" alt="stars"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/forks"><img src="https://img.shields.io/github/forks/zhaoxuya520/reverse-skill?style=flat&logo=github" alt="forks"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/issues"><img src="https://img.shields.io/github/issues/zhaoxuya520/reverse-skill?style=flat&logo=github" alt="issues"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-Keep%20a%20Changelog-orange" alt="changelog"></a>
</p>
<p align="center">
<a href="https://trendshift.io/repositories/43969?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-43969" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/43969" alt="zhaoxuya520%2Freverse-skill | Trendshift" width="250" height="55"/></a>
<a href="https://trendshift.io/repositories/43969?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-43969" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/43969/daily" alt="zhaoxuya520%2Freverse-skill | Trendshift" width="250" height="55"/></a>
</p>
<br/>
<p align="center">
<a href="#about">Informazioni</a> ·
<a href="#getting-started">Per iniziare</a> ·
<a href="#usage">Utilizzo</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md">Percorso rapido</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md">Instradamento</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops">Contratti ops</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md">Bootstrap AI</a> ·
<a href="#sponsors">Sponsor</a> ·
<a href="#contributing">Contributi</a>
</p>
<p align="center">
🌐 <a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/README_zh.md">Cinese</a>
</p>
<br/>
<a id="about"></a>
## Informazioni
> **Se sei un agente AI, vai a [README_AI.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md) e segui le istruzioni in modo rigoroso.**
Quando un agente AI (Claude Code, Codex, Cursor, OpenCode o un altro client compatibile) incontra un APK, un binario, una crittografia JS del frontend, una sfida CTF o un target di pentesting, questo pacchetto lo instrada verso la metodologia corretta, verifica gli strumenti disponibili ed esegue un flusso di lavoro ripetibile invece di indovinare i comandi.
```
User task
→ RULES.md
→ MASTER-ROUTING / master-route.ps1 (PRIMARY)
→ case-init / scope.md (auth + network_profile; no target ACT until ready)
→ Scenario skill → tools / MCP / scripts
→ timeline + Evidence→Finding→Path → report + field-journal
```
**Perché esiste:**
- Gli agenti AI non sanno se usare jadx, apktool, Frida, IDA o BurpSuite per un determinato compito
- Le attività su APK, ELF, JS, PCAP e CTF richiedono ciascuna playbook diversi
- Strumenti, server MCP e script sono sparsi su più macchine
- Gli stessi errori si ripetono perché l'esperienza non viene riutilizzata
### Stato attuale
| Regole di instradamento | Benchmark di regressione | Moduli di competenza principali | Piattaforme CI | Modello client |
|---:|---:|---:|---|---|
| 41 (R0–R40) | 163 casi | 42 moduli tracciati | Windows + Ubuntu | Indipendente dal client |
Il nucleo di instradamento è guidato da un'unica configurazione strutturata, validata dalla CI multipiattaforma e mantenuta separata dagli adattatori opzionali per i client.
Scaletta PRIMARY: [skills/MASTER-ROUTING.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md) · Matrice completa: [skills/routing.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md) · Ops: [skills/ops/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops)
<br/>
<div align="center">
<a href="https://afterglow.watch"><img src="https://afterglow.watch/badge/zhaoxuya520/reverse-skill" alt="star velocity"></a>
</div>
<br/>
<p align="right">(<a href="#about">torna in cima</a>)</p>
### Realizzato con
<p align="left">
<img src="https://skillicons.dev/icons?i=py,nodejs,powershell,bash,java,docker,git&theme=light" /><br/>
<code>IDA Pro</code> · <code>radare2</code> · <code>Ghidra</code>
</p>
<p align="right">(<a href="#about">torna in cima</a>)</p>
<a id="getting-started"></a>
## Per iniziare
### Prerequisiti
- **Java / JDK** — per jadx e apktool
- **Node.js 22.12+** — per la toolchain JS e i server MCP
- **Python 3.x** — per Frida e gli script di supporto
- **Un client AI per il codice** — Claude Code, Codex, Cursor, OpenCode o un altro client compatibile
### Installazione
```
git clone https://github.com/zhaoxuya520/reverse-skill.git
```
Quindi aggiorna l'indice degli strumenti per piattaforma:
| Piattaforma | Comando |
|----------|---------|
| Windows | `powershell -File skills/scripts/refresh-tool-index.ps1` |
| Linux / macOS | `bash skills/scripts/refresh-tool-index.sh` |
| Kali Linux | `bash kali/scripts/refresh-tool-index.sh` |
Consulta [skills/tool-index.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/tool-index.md) per vedere gli strumenti rilevati.
Documentazione specifica per piattaforma:
- **Kali Linux** → [kali/README-kali.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/kali/README-kali.md)
- **Ubuntu/Debian** → [docs/platforms/linux.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/docs/platforms/linux.md)
- **macOS** → [docs/platforms/macos.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/docs/platforms/macos.md)
<p align="right">(<a href="#getting-started">torna in cima</a>)</p>
<a id="usage"></a>
## Utilizzo
### Scenari supportati
| Scenario | Percorso |
|----------|-------|
| Analisi APK / Android | `skills/apk-reverse/` |
| iOS / mobile | `skills/mobile-reverse/` |
| Reverse di binari (exe/dll/so/elf) | `skills/ida-reverse/` / `skills/radare2/` |
| .NET / C# | `skills/dotnet-reverse/` |
| JS frontend / parametri crittografati | `skills/js-reverse/` |
| VM DSL / VM opcode JS personalizzata | `skills/reverse-engineering/dsl-vm-reverse/` |
| Cattura HTTP / replay delle richieste | anything-analyzer, Reqable MCP + `js-reverse/` |
| Malware / YARA | `skills/malware-analysis/` |
| Test di penetrazione / scansione | `skills/pentest-tools/` |
| Catena di attacco / orchestrazione red-team | `skills/attack-chain/` |
| Revisione delle prove del caso / consegna del report | `skills/case-review/` |
| Competizione CTF | `CTF-Sandbox-Orchestrator/` (42 sub-skills) |
| Firmware / IoT | `skills/firmware-pentest/` |
| Patch diff / N-day | `skills/patch-diff-exploit/` |
| Pwn / sviluppo di exploit | `skills/pwn-chain/` |
| EDR bypass | `skills/edr-bypass-re/` |
| API / GraphQL | `skills/api-security/` |
| Supply chain / SBOM | `skills/supply-chain-security/` |
| Sicurezza LLM / AI | `skills/llm-security/` |
| Deofuscazione OLLVM | `skills/reverse-engineering/references/ollvm-deobfuscation.md` |
| Diagrammi / report | `skills/diagram-generator/` / `skills/docs-generator/` |
### File principali
| File | Scopo |
|------|---------|
| [README_AI.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md) | Avvio e configurazione dell'agente AI |
| [RULES.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/RULES.md) | Regole di instradamento globali (gate di ambito prima di ACT) |
| [skills/MASTER-ROUTING.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md) | Scaletta rapida PRIMARY |
| [skills/routing.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md) | Matrice di instradamento attività → competenza |
| [skills/SKILL.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/SKILL.md) | Punto di ingresso principale |
| [skills/INDEX.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/INDEX.md) | Indice di navigazione delle competenze auto-generato e indipendente dal client |
| [skills/config/routing.json](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/config/routing.json) | **Fonte unica di verità per l'instradamento** (41 regole, R0–R40) |
| [skills/tool-index.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/tool-index.md) | Stato locale degli strumenti (auto-generato) |
| [skills/scripts/master-route.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/master-route.ps1) | Triage PRIMARY in un'unica esecuzione (legge routing.json) |
| [skills/scripts/case-init.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/case-init.ps1) | Directory del caso: ambito / timeline / elementi di lavoro |
| [skills/case-review/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/case-review) | Revisione di sola lettura del grafo delle Prove e controlli di integrità degli artefatti |
| [skills/scripts/test-routing.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/test-routing.ps1) | Esecutore di regressione dell'instradamento (163 casi benchmark) |
| [skills/scripts/verify-routing-coherence.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/verify-routing-coherence.ps1) | Controlli del gate di struttura e di blocco della supply chain |
| [skills/scripts/extract-summaries.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/extract-summaries.ps1) | Rigenera INDEX.md dal frontmatter delle competenze |
| [AGENTS.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/AGENTS.md) | Istruzioni di repository indipendenti dalla piattaforma |
| [skills/ops/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops) | Ambito, catena delle Prove, ruoli, timeline (modulo skill-router) |
### Test (eseguire dopo qualsiasi modifica a routing/config)
```powershell
# 1. Routing regression — 163 (hint → expected PRIMARY) cases, fails CI on any mismatch
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/test-routing.ps1
# 2. Structure coherence + supply-chain pin gate (unpinned auto-install fails)
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/verify-routing-coherence.ps1
# 3. Smoke: verify + script parse + quick route matrix
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/smoke.ps1
# 4. INDEX.md drift check (regenerate with extract-summaries.ps1 if dirty)
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/extract-summaries.ps1 -Check
```
La CI di GitHub Actions esegue tutti i controlli sopra elencati su **Windows + Ubuntu** per ogni push/PR.
### Integrazione indipendente dal client
Il nucleo di instradamento, la suite di regressione, i manifest e il flusso di lavoro del caso non dipendono da uno specifico client AI. Claude Code, Codex, Cursor, OpenCode e altri client dovrebbero caricare il repository tramite il proprio adattatore o meccanismo di istruzioni di progetto. La configurazione specifica del client deve rimanere opzionale e al di fuori del contratto di instradamento di base.
### Struttura del repository
```
.
├── README.md / README_zh.md / README_AI.md
├── RULES.md / RULES_zh.md
├── skills/
│ ├── MASTER-ROUTING.md / SKILL.md / routing.md
│ ├── ops/ # ops contracts
│ ├── scripts/ # master-route, case-init, bootstrap, verify
│ ├── field-journal/
│ ├── apk-reverse/ mobile-reverse/ js-reverse/ dotnet-reverse/
│ ├── ida-reverse/ radare2/ reverse-engineering/ malware-analysis/
│ ├── pentest-tools/ attack-chain/ pwn-chain/ firmware-pentest/
│ ├── api-security/ supply-chain-security/ llm-security/
│ └── ...
├── CTF-Sandbox-Orchestrator/
├── docs/
├── kali/ # see kali/README-kali.md
└── work/ # local cases (gitignored)
```
<p align="right">(<a href="#usage">torna in cima</a>)</p>
<a id="sponsors"></a>
## Sponsor
La sponsorizzazione aiuta a mantenere i benchmark di instradamento, la CI multipiattaforma, la documentazione e la libreria pubblica dei flussi di lavoro di sicurezza.
### Sponsor attuale
<table align="center">
<tr>
<td align="center" width="440">
<a href="https://www.atlascloud.ai/?ref=W3Q77C">
<img src="https://www.atlascloud.ai/oss-program/powered-by-atlas-cloud.svg" alt="Alimentato da Atlas Cloud" height="44" />
</a>
<br />
<strong>Atlas Cloud</strong>
<br />
<sub>Fornitore di servizi di modelli linguistici di grandi dimensioni</sub>
</td>
</tr>
</table>
### Sponsorizza questo progetto
<p align="center">
<a href="mailto:[email protected]?subject=%5BSponsorship%5D%20reverse-skill">
<img src="https://img.shields.io/badge/Email%[email protected]?style=for-the-badge&logo=gmail&logoColor=white" alt="Email us — [email protected]" />
</a>
</p>
<p align="center"><sub>Gli sponsor confermati possono essere menzionati qui con nome, logo e link al progetto.</sub></p>
<p align="right">(<a href="#sponsors">torna in cima</a>)</p>
<a id="contributing"></a>
## Contributi
I contributi sono benvenuti! Fai il fork del repository, crea un branch per la funzionalità e apri una PR.
1. Fai il fork del Progetto
2. `git checkout -b feature/AmazingFeature`
3. `git commit -m 'Add some AmazingFeature'`
4. `git push origin feature/AmazingFeature`
5. Apri una Pull Request
### Collaboratori
<a href="https://github.com/zhaoxuya520/reverse-skill/graphs/contributors">
<img src="https://contrib.rocks/image?repo=zhaoxuya520/reverse-skill" alt="contributori" />
</a>
<p align="right">(<a href="#contributing">torna in cima</a>)</p>
<a id="license"></a>
## Licenza
Questo progetto (`reverse-skill`) è concesso principalmente in licenza sotto la **MIT License** (vedi [LICENSE](https://github.com/zhaoxuya520/reverse-skill/blob/main/LICENSE)).
**Dipendenze di sottomoduli e di terze parti:**
- **CTF-Sandbox-Orchestrator/**: **GNU GPLv3**
- **Pentest Swarm AI**: il progetto originale è **AGPL-3.0**. Questo repository lo invoca solo tramite CLI o MCP e non include il suo codice sorgente
- Gli altri strumenti (jadx, frida, nmap, burpsuite-mcp, ecc.) sono soggetti alle rispettive licenze ufficiali
<p align="right">(<a href="#license">torna in cima</a>)</p>
<a id="acknowledgments"></a>
## Riconoscimenti
Grazie a tutti gli autori di strumenti open-source. Questo progetto integra strumenti che spaziano dal reverse engineering al penetration testing, dal CTF all'analisi della sicurezza: ogni strumento è il frutto del lavoro della comunità.
Un ringraziamento speciale ai contributori dell'ecosistema di deofuscazione OLLVM e a tutti coloro che hanno inviato campioni di test, segnalazioni e PR.
<p align="right">(<a href="#acknowledgments">torna in cima</a>)</p>
## Contatti
- **Email:** [[email protected]](mailto:[email protected])
- **Gruppo QQ:** 942400892
- **Discord:** [comunità reverse-skill](https://discord.gg/TECd3bMRR)
- **Issues:** [GitHub Issues](https://github.com/zhaoxuya520/reverse-skill/issues)