reverse-skill

1. Projektüberblick

reverse-skill ist ein Cybersicherheits-Skills-Router, der KI-Coding-Agenten (und die Menschen, die mit ihnen arbeiten) durch strukturierte, wiederholbare Workflows für Reverse Engineering, Penetrationstests und CTF-artige Sicherheitsaufgaben führt – und damit ad-hoc-Raterei durch ein regelbasiertes Routing-System ersetzt, das für ein gegebenes Ziel die richtige Methodik und die passenden Werkzeuge auswählt.

2. Hintergrund & Positionierung

• Kernauftrag: KI-Agenten werden zunehmend damit beauftragt, APKs, Binärdateien, verschlüsseltes JavaScript, Firmware oder CTF-Aufgaben zu analysieren, doch ihnen fehlt in der Regel ein systematischer Weg, um zu entscheiden, welche Technik oder welches Werkzeug für welche Situation geeignet ist. reverse-skill schließt diese Lücke, indem es Experten-Routing-Logik kodiert – „Benutzeraufgabe → RULES.md → MASTER-ROUTING → Fallinitialisierung → szenariospezifischer Skill → Beweissammlung → Berichterstattung“ –, sodass Agenten einem konsistenten, nachvollziehbaren Pfad folgen, statt zu improvisieren.
• Abgrenzung: Statt ein einzelnes Werkzeug oder ein Wrapper um ein einzelnes Dienstprogramm zu sein, ist reverse-skill eine Routing- und Orchestrierungsschicht, die auf dem bestehenden Ökosystem an Sicherheitswerkzeugen aufsetzt (jadx, apktool, Frida, Burp, YARA und weitere). Sein Wert liegt in den 43 Routing-Regeln und 173 Regressionstests, die die Aufgabenklassifizierung konsistent halten, sowie in einem clientneutralen Design, das über Claude Code, Cursor, Cline und andere KI-Coding-Umgebungen hinweg gleich funktioniert.

3. Funktionskategorien

• 📱 Mobile Analyse — Analyse von APK- und iOS-Apps; zu den repräsentativen Skills gehören statische Dekompilierung, dynamische Instrumentierung und Zertifikats-/Signaturprüfung. Zweck: App-Verhalten und Schwachstellen in mobilen Binärdateien aufdecken.
• 🧩 Binäres Reverse Engineering — Umgang mit ELF-, EXE-, DLL- und SO-Dateien; Disassemblierung, Symbolwiederherstellung und Kontrollflussanalyse. Zweck: kompilierte Binärdateien zurück in verständliche Logik verwandeln.
• 🔐 .NET-/C#-Dekompilierung — Wiederherstellung der quellcode-nahen Struktur aus .NET-Assemblys. Zweck: Anwendungen mit verwaltetem Code ohne Originalquellcode analysieren.
• 🕸️ JavaScript-Verschlüsselungsanalyse — Deobfuskierung und Nachverfolgung von Entschlüsselungsroutinen für Frontend-/Web-JavaScript. Zweck: clientseitige Verschlüsselungslogik verstehen, die von Web-Apps und APIs verwendet wird.
• 🛡️ Malware-Erkennung & YARA — Signaturbasierte und verhaltensbezogene Malware-Analyse. Zweck: schädliche Proben mithilfe von YARA-Regeln klassifizieren und erkennen.
• 🎯 Penetrationstests & Scanning — Strukturierte Scan- und Exploit-Workflows für autorisierte Ziele. Zweck: die Angriffsfläche von Systemen innerhalb eines expliziten Testumfangs bewerten.
• 🏁 CTF-Wettbewerbe — 42 dedizierte CTF-Teilskills, die gängige Aufgabenkategorien abdecken (pwn, crypto, web, reverse, forensics). Zweck: wettbewerbsbereite Workflows für Capture-the-Flag-Veranstaltungen bereitstellen.
• 🔌 Firmware- & IoT-Bewertung — Extraktion und Analyse eingebetteter Firmware-Images. Zweck: den Sicherheitsstatus von IoT-Geräten bewerten.
• 💥 Exploit-Entwicklung & Pwn-Ketten — Geführte Konstruktion von Proof-of-Concept-Exploit-Ketten. Zweck: die Auswirkung von Schwachstellen in kontrollierten Umgebungen validieren.
• 🌐 API- & GraphQL-Sicherheit — Endpunkt-Erkennung sowie Autorisierungs- und Logiktests für APIs. Zweck: unsicheres API-Design und Lücken in der Zugriffskontrolle identifizieren.
• 📦 Lieferkettenanalyse — Prüfung von Abhängigkeiten und Build-Pipelines. Zweck: Manipulationen oder schädliche Pakete in der Software-Lieferkette erkennen.
• 🤖 LLM-/KI-Sicherheit — Bewertung von Prompt-Injection, Modellmissbrauch und agentenspezifischen Angriffsflächen. Zweck: die traditionelle Sicherheitsprüfung auf KI-gestützte Systeme ausweiten.

4. Wichtige Highlights

• Regelbasierte Routing-Engine — 43 Routing-Regeln (R0–R44), definiert in routing.json, dienen als einzige verlässliche Quelle dafür, wie Aufgaben klassifiziert und zugewiesen werden.
• Regressionstest-gestützte Zuverlässigkeit — 173 Regressionstestfälle validieren Routing-Entscheidungen und verringern das Risiko, dass eine Regeländerung stillschweigend einen bestehenden Workflow beschädigt.
• Plattformübergreifende CI — Automatisierte Validierung sowohl unter Windows als auch unter Ubuntu stellt sicher, dass Routing und Skripte sich über Betriebssysteme hinweg konsistent verhalten.
• Clientneutrales Design — Funktioniert einheitlich über Claude Code, Cursor, Cline und andere KI-Coding-Assistenten hinweg, sodass Teams nicht an eine einzige Agentenplattform gebunden sind.
• Strukturierter Fall-Lebenszyklus — Jede Aufgabe durchläuft Fallinitialisierung, Beweissammlung und Berichterstattung und erzeugt nachvollziehbare Ergebnisse statt einmaliger Wegwerfarbeit.
• Explizite Autorisierungsschranken — RULES.md erzwingt Umfangs- und Autorisierungsprüfungen, bevor ein offensiv ausgerichteter Workflow fortgesetzt wird, und hält die Nutzung ausschließlich im Rahmen autorisierter Tests.

5. Anwendungsfälle nach Rolle

• Allgemeine Entwickler: Nutzen Sie die Skills zur JavaScript-Verschlüsselungsanalyse und .NET-Dekompilierung, um Drittanbieter-Code zu verstehen oder verschleierte Abhängigkeiten zu debuggen.
• Sicherheitsingenieure / Penetrationstester: Nutzen Sie das vollständige Routing-System – Mobile-, Binär-, API- und Exploit-Entwicklungs-Skills –, um konsistente, gut dokumentierte Einsätze gegen autorisierte Ziele durchzuführen.
• CTF-Spieler: Verwenden Sie die 42 CTF-Teilskills als fertiges Playbook für die Aufgabenkategorien pwn, crypto, web, reverse und forensics.
• KI-Agenten-Entwickler: Integrieren Sie reverse-skill als Routing-Schicht, damit jeder auf Claude Code / Cursor / Cline basierende Agent zuverlässig die richtige Sicherheitsmethodik wählen kann, statt zu raten.

6. Erste Schritte

Finden, was Sie brauchen – beginnen Sie bei den Routing-Einstiegspunkten:

cat MASTER-ROUTING.md
cat RULES.md

Installieren / Integrieren – klonen Sie das Repository und führen Sie das plattformspezifische Aktualisierungsskript aus, um verfügbare Sicherheitswerkzeuge zu erkennen (erfordert JDK, Node.js 22.12+ und Python 3.x):

git clone https://github.com/zhaoxuya520/reverse-skill.git
cd reverse-skill
# Führen Sie das Aktualisierungsskript für Ihre Plattform aus, z. B.:
./scripts/refresh.sh        # Kali/Ubuntu/macOS
scripts/refresh.ps1         # Windows

Beitragen – Standard-Workflow mit Fork und Pull Request:

git checkout -b feature/my-skill
git commit -m "Add my-skill"
git push origin feature/my-skill
# Öffnen Sie anschließend einen Pull Request auf GitHub

7. Projektstruktur

reverse-skill/
├── skills/              # Zentrale Routing-Regeln, Workflows und domänenspezifische Skills
├── CTF-Sandbox/         # 42 CTF-Teilskills (GPLv3-lizenzierter Orchestrator)
├── scripts/             # Master-Routing, Fallinitialisierung und Testskripte
├── docs/                # Plattformspezifische Anleitungen (Kali, Ubuntu/Debian, macOS)
└── work/                # Lokale Falldaten (gitignored)

Schlüsseldateien:

• MASTER-ROUTING.md – die primäre Schnellzuordnungs-Leiter für eingehende Aufgaben.
• routing.json – einzige verlässliche Quelle für die 43 Routing-Regeln.
• README_AI.md – Bootstrap-Anweisungen, die speziell für KI-Agenten geschrieben wurden.
• RULES.md – globale Umfangsschranken und Autorisierungsprüfungen, die bestanden werden müssen, bevor ein Skill ausgeführt wird.

8. Verwandtes Ökosystem

• Vorgelagerte Werkzeuge, die es einbindet oder von denen es abhängt: jadx und apktool (Android-Dekompilierung), Frida (dynamische Instrumentierung), Burp Suite (Web-/API-Tests), YARA (Malware-Signaturen).
• KI-Agentenplattformen, mit denen es sich integriert: Claude Code, Cursor, Cline und andere kompatible KI-Coding-Umgebungen.
• Ergänzende Infrastruktur-Sponsoren: Atlas Cloud (KI-Inferenzplattform) und Kite AI (Identitäts-/Zahlungsinfrastruktur für die Agentenwirtschaft) unterstützen den Betrieb des Projekts.

9. Lizenz

• ✅ Sie dürfen das Kernprojekt unter der MIT-Lizenz verwenden, kopieren, verändern und verbreiten, auch für kommerzielle Zwecke, sofern der Urheberrechtshinweis erhalten bleibt.
• ✅ Sie dürfen die CTF-Sandbox-Orchestrator-Komponente verwenden, die separat unter GPLv3 lizenziert ist – Copyleft-Bedingungen gelten, wenn Sie veränderte Versionen weiterverbreiten.
• ❌ Verwenden Sie keinen Skill dieses Projekts gegen Systeme, die Ihnen nicht gehören oder für die Ihnen keine ausdrückliche Testgenehmigung vorliegt – dies ist eine harte Anforderung, die in den eigenen Regeln des Projekts festgehalten ist, nicht nur ein allgemeiner rechtlicher Hinweis.
• ℹ️ Gebündelte oder referenzierte Drittanbieter-Werkzeuge (jadx, Frida, Burp usw.) behalten ihre eigenen ursprünglichen Lizenzen, die von MIT/GPLv3 abweichen können und separat geprüft werden sollten.

10. FAQ

F: Muss ich alle vorausgesetzten Werkzeuge installiert haben, bevor ich reverse-skill verwende?
A: Nein – die Aktualisierungsskripte (scripts/refresh.sh / scripts/refresh.ps1) erkennen, welche Werkzeuge auf Ihrem System bereits verfügbar sind, und leiten Aufgaben entsprechend weiter; fehlende Werkzeuge werden gemeldet, statt stillschweigend vorausgesetzt zu werden.

F: Kann ich reverse-skill für reale Penetrationstests verwenden, nicht nur für CTFs?
A: Ja, aber nur gegen Systeme, die Ihnen gehören oder für die Sie eine ausdrückliche schriftliche Testgenehmigung haben – dies wird durch die Umfangs- und Autorisierungsschranken in RULES.md durchgesetzt.

F: Mit welchen KI-Coding-Assistenten funktioniert das?
A: Das Routing-System ist clientneutral und wurde mit Claude Code, Cursor und Cline validiert; jede kompatible KI-Coding-Umgebung sollte dieselben Routing-Dateien nutzen können.

F: Warum verwendet der CTF-Sandbox-Orchestrator eine andere Lizenz (GPLv3) als der Rest des Projekts (MIT)?
A: Es handelt sich um ein separat gepflegtes Submodul mit eigener Lizenzentscheidung; prüfen Sie die Lizenzdatei in CTF-Sandbox/, bevor Sie speziell diese Komponente weiterverbreiten.

F: Wie füge ich einen neuen Skill oder eine neue Routing-Regel hinzu?
A: Erstellen Sie einen Fork des Repositorys, fügen Sie Ihren Skill unter skills/ (oder unter CTF-Sandbox/ für CTF-spezifische Skills) hinzu, aktualisieren Sie routing.json, falls eine neue Regel erforderlich ist, stellen Sie sicher, dass die Regressionstests bestanden werden, und öffnen Sie einen Pull Request.

11. Schnelllinks

• Repository: https://github.com/zhaoxuya520/reverse-skill
• Routing-Einstiegspunkt: MASTER-ROUTING.md (im Repository-Stammverzeichnis)
• Beitragen: Standard-GitHub-Workflow mit Fork und Pull Request (siehe Repository-Stammverzeichnis für etwaige CONTRIBUTING-Hinweise)
• Community/Diskussionen: GitHub Issues und Pull Requests im Repository

12. Zusammenfassung

reverse-skill verwandelt ad-hoc-artige Sicherheitsanalysen nach dem Prinzip Versuch und Irrtum in einen strukturierten, regelgesteuerten Workflow, dem KI-Agenten und menschliche Praktiker über die Bereiche Mobile, Binärdateien, Web, Firmware und CTF hinweg konsistent folgen können. Es eignet sich am besten für Sicherheitsingenieure, CTF-Teilnehmer und KI-Agenten-Entwickler, die ein zuverlässiges, nachvollziehbares Routing zwischen Sicherheitsaufgaben und den richtigen Werkzeugen benötigen – stets innerhalb der Grenzen autorisierter Tests.