apk-reverse is a tool for Android APK reverse engineering, debloating, ad removal, surgical dex patching, repacking, and runtime or server analysis.
The tool addresses the challenge of analyzing and modifying Android applications by providing structured workflows for APK manipulation. It operates as an agent skill designed to be consumed by AI assistants like Claude Code or Codex, organizing its guidance through progressive disclosure: a decision-oriented procedure document, detailed references loaded on demand, and parameterized scripts ready for direct execution. The approach emphasizes gated workflows with explicit pass criteria, symptom-indexed failure catalogs, and override rules to prevent reasoning past known problems.
The tool suits developers and security researchers who need to analyze, modify, or remove components from Android applications. It is particularly valuable for those working with AI-assisted workflows, as it structures knowledge specifically for agent consumption rather than human tutorial reading. The project acknowledges that its failure mode is not ignorance but models reasoning from first principles despite available guidance, so it implements procedural gates, symptom indices as stop signals, and a two-strike rule to prevent repeated attempts at the same failed hypothesis.
Development activity shows active maintenance with continuous integration workflows in place. The project maintains both English and Chinese documentation, indicating sustained effort toward accessibility. The codebase is written in Python and targets Python 3.9 and later, with explicit scope documentation and a failure catalogue that reflects accumulated operational experience.
