---
id: 7481
canonical_url: "https://phying.com/item/7481"
title: "zhaoxuya520/reverse-skill: Reverse Engineering / Authorized Penetration Testing / Security Research Skill Router Pack"
type: "tool"
cve: null
cvss: null
severity: "unknown"
vendor: null
product: "reverse-skill"
affected_versions: null
source_domain: "github.com"
source_url: "https://github.com/zhaoxuya520/reverse-skill"
published_at: null
snapshot_at: "2026-10-26T06:03:00Z"
archived_by: "Phying News (https://phying.com/item/7481)"
lang: "en"
---

# reverse-skill

### Cybersecurity Skills Router · 逆向技能路由包

*Navigate the dark waters, sail against the stream.*

*Source: [github.com/zhaoxuya520/reverse-skill](https://github.com/zhaoxuya520/reverse-skill)*

[![release v1.0.1](https://img.shields.io/badge/release-v1.0.1-blue)](https://github.com/zhaoxuya520/reverse-skill/releases)
[![stars](https://img.shields.io/github/stars/zhaoxuya520/reverse-skill?style=flat&logo=github)](https://github.com/zhaoxuya520/reverse-skill/stargazers)
[![forks](https://img.shields.io/github/forks/zhaoxuya520/reverse-skill?style=flat&logo=github)](https://github.com/zhaoxuya520/reverse-skill/forks)
[![issues](https://img.shields.io/github/issues/zhaoxuya520/reverse-skill?style=flat&logo=github)](https://github.com/zhaoxuya520/reverse-skill/issues)
[![license](https://img.shields.io/badge/license-MIT-green)](https://github.com/zhaoxuya520/reverse-skill/blob/main/LICENSE)
[![changelog](https://img.shields.io/badge/changelog-Keep%20a%20Changelog-orange)](https://github.com/zhaoxuya520/reverse-skill/blob/main/CHANGELOG.md)

[About](#about) · [Getting Started](#getting-started) · [Usage](#usage) · [Tutorial](https://reverse.apivix.com/docs/) · [Fast route](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md) · [Routing](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md) · [Ops contracts](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops) · [AI Bootstrap](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md) · [Contributing](#contributing)

🌐 [中文](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_zh.md) · [Project website](https://reverse.apivix.com/) · [Online tutorial](https://reverse.apivix.com/docs/)

## About

> **If you are an AI Agent, jump to [README_AI.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md) and follow the instructions strictly.**

When an AI agent (Claude Code, Codex, Cursor, OpenCode, or another compatible client) encounters an APK, a binary, frontend JS encryption, a CTF challenge, or a pentesting target, this package routes it to the right methodology, checks available tools, and executes a repeatable workflow instead of guessing commands.

```
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
```

**Why this exists:**
- AI agents don't know whether to use jadx, apktool, Frida, IDA, or BurpSuite for a given task.
- APK, ELF, JS, PCAP, and CTF tasks each need different playbooks.
- Tools, MCP servers, and scripts are scattered across machines.
- The same mistakes get repeated because experience isn't reused.

### Current status

| Routing rules | Regression benchmark | Core skill modules | CI platforms | Client model |
| --- | --- | --- | --- | --- |
| 44 (R0–R45) | 175 cases | 45 tracked modules | Windows + Ubuntu | Client-neutral |

The routing core is driven by one structured configuration, validated by cross-platform CI, and kept separate from optional client adapters.

PRIMARY ladder: [skills/MASTER-ROUTING.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md) · Full matrix: [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)

### Built With

`IDA Pro` · `radare2` · `Ghidra` · `Binary Ninja`

## Getting Started

### Prerequisites

- **Java / JDK** — for jadx and apktool
- **Node.js 22.12+** — for JS toolchain and MCP servers
- **Python 3.x** — for Frida and helper scripts
- **A code AI client** — Claude Code, Codex, Cursor, OpenCode, or another compatible client

### Installation

```bash
git clone https://github.com/zhaoxuya520/reverse-skill.git
```

Then refresh the tool index per platform:

| Platform | Command |
| --- | --- |
| 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` |

Check [skills/tool-index.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/tool-index.md) to see detected tools.

Platform-specific docs:
- **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)

## Usage

### Supported scenarios

| Scenario | Entry |
| --- | --- |
| APK / Android analysis | `skills/apk-reverse/` |
| iOS / mobile | `skills/mobile-reverse/` |
| Binary reverse (exe/dll/so/elf) | `skills/ida-reverse/` / `skills/radare2/` |
| Binary Ninja / HLIL / MLIL / MCP | `skills/binary-ninja-reverse/` |
| .NET / C# | `skills/dotnet-reverse/` |
| Frontend JS / encrypted params | `skills/js-reverse/` |
| DSL VM / custom JS opcode VM | `skills/reverse-engineering/dsl-vm-reverse/` |
| HTTP capture / request replay | anything-analyzer, Reqable MCP + `js-reverse/` |
| Malware / YARA | `skills/malware-analysis/` |
| Penetration testing / scanning | `skills/pentest-tools/` |
| Attack chain / red-team orchestration | `skills/attack-chain/` |
| Case evidence review / report handoff | `skills/case-review/` |
| CTF competition | `CTF-Sandbox-Orchestrator/` (42 sub-skills) |
| Firmware / IoT | `skills/firmware-pentest/` |
| Patch diff / N-day | `skills/patch-diff-exploit/` |
| Pwn / exploit development | `skills/pwn-chain/` |
| EDR bypass | `skills/edr-bypass-re/` |
| API / GraphQL | `skills/api-security/` |
| Supply chain / SBOM | `skills/supply-chain-security/` |
| LLM / AI security | `skills/llm-security/` |
| OLLVM deobfuscation | `skills/reverse-engineering/references/ollvm-deobfuscation.md` |
| Diagrams / reports | `skills/diagram-generator/` / `skills/docs-generator/` |

### Key files

| File | Purpose |
| --- | --- |
| [README_AI.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md) | AI agent bootstrap and configuration |
| [RULES.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/RULES.md) | Global routing rules (scope gate before ACT) |
| [skills/MASTER-ROUTING.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md) | PRIMARY fast ladder |
| [skills/routing.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md) | Task → skill routing matrix |
| [skills/SKILL.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/SKILL.md) | Master entry point |
| [skills/INDEX.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/INDEX.md) | Auto-generated, client-neutral skill navigation index |
| [skills/config/routing.json](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/config/routing.json) | **Routing single source of truth** (43 rules, R0–R44) |
| [skills/tool-index.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/tool-index.md) | Local tool status (auto-generated) |
| [skills/scripts/master-route.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/master-route.ps1) | One-shot PRIMARY triage (reads routing.json) |
| [skills/scripts/case-init.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/case-init.ps1) | Case dir: scope / timeline / workitems |
| [skills/case-review/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/case-review) | Read-only Evidence graph review and artifact fixity checks |
| [skills/scripts/test-routing.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/test-routing.ps1) | Routing regression runner (173 benchmark cases) |
| [skills/scripts/verify-routing-coherence.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/verify-routing-coherence.ps1) | Structure + supply-chain pin gate checks |
| [skills/scripts/extract-summaries.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/extract-summaries.ps1) | Regenerates INDEX.md from skill frontmatter |
| [AGENTS.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/AGENTS.md) | Platform-neutral repository instructions |
| [skills/ops/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops) | Scope, Evidence chain, roles, timeline (skill-router form) |

### Testing (run after any routing/config change)

```bash
# 1. Routing regression — 173 (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
```

GitHub Actions CI runs all of the above on **Windows + Ubuntu** for every push/PR.

### Client-neutral integration

The routing core, regression suite, manifests, and case workflow do not depend on a specific AI client. Claude Code, Codex, Cursor, OpenCode, and other clients should load the repository through their own adapter or project-instruction mechanism. Client-specific configuration must remain optional and outside the core routing contract.

For Codex, the repository also exposes an optional adapter plugin at [`plugins/reverse-skill/`](https://github.com/zhaoxuya520/reverse-skill/blob/main/plugins/reverse-skill). It delegates to the repository's existing routing core and does not register external MCP servers automatically.

### Repository layout

```
.
├── 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)
```

## Contributing

Contributions are welcome! Fork the repo, create a feature branch, and open a PR.

## License

This project (`reverse-skill`) is primarily licensed under the **MIT License** (see [LICENSE](https://github.com/zhaoxuya520/reverse-skill/blob/main/LICENSE)).

**Submodule and third-party dependencies:**
- **CTF-Sandbox-Orchestrator/**: **GNU GPLv3**
- **Pentest Swarm AI**: Original project is **AGPL-3.0**. This repo only invokes it via CLI or MCP and does not include its source code
- Other tools (jadx, frida, nmap, burpsuite-mcp, etc.) are subject to their respective official licenses

## Disclaimer

This project is intended solely for lawful security research, education, CTF competitions, and testing of systems that you own or have explicit authorization to assess.

**Unauthorized access, scanning, exploitation, disruption, data acquisition, or any other use against systems without prior permission is strictly prohibited.**

---
> 📦 **Full-Text Markdown Snapshot** archived by [Phying News](https://phying.com/item/7481) · Original source: [github.com/zhaoxuya520/reverse-skill](https://github.com/zhaoxuya520/reverse-skill)