How newliver666/apk-reverse works
apk-reverse is an Agent Skill and toolkit for Android APK reverse engineering, patching, runtime investigation, and repacking. Its principal workflow is to check host/device capabilities, inspect or recover target code, identify and bound a change, patch at a suitable layer, then validate and package the deliverable. Separate branches cover native and protocol analysis, on-device workflows, and runtime instrumentation. The excerpts show dex-tool imports and the documented doctor entry point; several other script-to-stage mappings are inferred from names and README capabilities, so those links are marked unverified.
Main entry points: dexutil.py DEX reader · doctor.py Environment doctor · dex_find_insn.py Instruction search · find_refs.py Reference analysis
Components 22
Environment
- Environment doctor
skills/apk-reverse/scripts/doctor.py - Capability registry
skills/apk-reverse/scripts/capabilities.py
APK Analysis
- DEX reader
skills/apk-reverse/scripts/dexutil.py - Instruction search
skills/apk-reverse/scripts/dex_find_insn.py - Reference analysis
skills/apk-reverse/scripts/find_refs.py - Dump validation
skills/apk-reverse/scripts/dex_dump_validate.py - VMP comparison
skills/apk-reverse/scripts/vmp_diff_harness.py - APK comparison
skills/apk-reverse/scripts/apk_diff.py - Blob decoding
skills/apk-reverse/scripts/blob_decode.py - Native analysis
skills/apk-reverse/scripts/elf_plt.py - Protocol decoding
skills/apk-reverse/scripts/protobuf_decode_raw.py
Modification
- DEX byte patching
skills/apk-reverse/scripts/dex_patch_bytes.py - Smali patching
skills/apk-reverse/scripts/patch_smali.py - APK repacking
skills/apk-reverse/scripts/repack.py
Runtime Analysis
- Runtime probing
skills/apk-reverse/scripts/run_probe.py - Frida instrumentation
skills/apk-reverse/scripts/frida_probe.js - Frida RPC service
skills/apk-reverse/scripts/frida_rpc_serve.py - Crash analysis
skills/apk-reverse/scripts/native_crash.py - TLS analysis
skills/apk-reverse/scripts/tls_check.py - Instruction tracing
skills/apk-reverse/scripts/stalker_trace.js
Other components
- Reverse engineer
- Android device
Connections 21
- Reverse engineer → Environment doctor: checks first
README.md - Environment doctor → Capability registry: queries capabilities
skills/apk-reverse/scripts/doctor.py - Reverse engineer → Android device: investigates on
- Reverse engineer → Dump validation: validates dumps
- Reverse engineer → Instruction search: locates code
- Instruction search → DEX reader: uses reader
skills/apk-reverse/scripts/dex_find_insn.py - Reference analysis → DEX reader: uses reader
skills/apk-reverse/scripts/find_refs.py - Dump validation → DEX reader: uses reader
skills/apk-reverse/scripts/dex_dump_validate.py - VMP comparison → DEX reader: uses reader
skills/apk-reverse/scripts/vmp_diff_harness.py - Reverse engineer → Reference analysis: checks blast radius
- Reverse engineer → DEX byte patching: patches DEX
- Reverse engineer → Smali patching: patches smali
- Reverse engineer → APK repacking: packages result
- Reverse engineer → Native analysis: analyzes libraries
- Reverse engineer → Protocol decoding: analyzes protocols
- Reverse engineer → Runtime probing: probes runtime
- Reverse engineer → Frida instrumentation: instruments runtime
- Reverse engineer → Frida RPC service: calls routines
- Reverse engineer → Crash analysis: investigates crashes
- Reverse engineer → TLS analysis: checks TLS
- Reverse engineer → Instruction tracing: traces execution