Skip to content
Back to search

android-reverse-engineering-skill

Claude Code plugins for Android reverse engineering

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/simoneavogadro-android-reverse-engineering-skill/badge.svg)](/listings/simoneavogadro-android-reverse-engineering-skill)

HTML

<a href="/listings/simoneavogadro-android-reverse-engineering-skill"><img src="/api/listings/simoneavogadro-android-reverse-engineering-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

From GitHub (recommended)

Inside Claude Code, run:

/plugin marketplace add SimoneAvogadro/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

The skill will be permanently available in all future sessions.

From a local clone

git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git

Then in Claude Code:

/plugin marketplace add /path/to/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 27 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "android-reverse-engineering-skill",
  4. "description": "Claude Code plugins for Android reverse engineering",
  5. "owner": {
  6. "name": "Simone Avogadro"
  7. },
  8. "metadata": {
  9. "description": "Claude Code plugins for Android reverse engineering",
  10. "version": "1.5.0"
  11. },
  12. "plugins": [
  13. {
  14. "name": "android-reverse-engineering",
  15. "source": "./plugins/android-reverse-engineering",
  16. "description": "Decompile Android APK/JAR/AAR with jadx, trace call flows through libraries, and document extracted APIs.",
  17. "version": "1.5.0",
  18. "author": {
  19. "name": "Simone Avogadro"
  20. },
  21. "repository": "https://github.com/SimoneAvogadro/android-reverse-engineering-skill",
  22. "license": "Apache-2.0",
  23. "keywords": ["android", "reverse-engineering", "apk", "jadx", "decompile", "api-extraction"],
  24. "category": "security"
  25. }
  26. ]
  27. }
README.md · README · 231 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Android Reverse Engineering & API Extraction — Claude Code skill
  2. [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![GitHub stars](https://img.shields.io/github/stars/SimoneAvogadro/android-reverse-engineering-skill?style=social)](https://github.com/SimoneAvogadro/android-reverse-engineering-skill/stargazers) [![GitHub last commit](https://img.shields.io/github/last-commit/SimoneAvogadro/android-reverse-engineering-skill)](https://github.com/SimoneAvogadro/android-reverse-engineering-skill/commits/master)
  3. A Claude Code skill that decompiles Android APK/XAPK/JAR/AAR files and **extracts the HTTP APIs** used by the app — Retrofit endpoints, OkHttp calls, hardcoded URLs, authentication patterns — so you can document and reproduce them without the original source code.
  4. > **First-class Kotlin support**: modern Android apps are Kotlin/KMP, heavily obfuscated with R8. This skill recovers the **original Kotlin class names** from metadata R8 cannot strip, and extracts APIs from **Ktor**, **Apollo (GraphQL)** and **Koin** — not just the classic Retrofit/OkHttp stack. See [Kotlin name recovery](#kotlin-name-recovery-r8-deobfuscation) below.
  5. > **Windows / PowerShell support (experimental)**: The `*.ps1` scripts alongside the bash ones are a recent community contribution, still being stabilised. For any issues please open an issue on **this** repository (not on the contributors' upstream forks): the PowerShell scripts are maintained here by [@SimoneAvogadro](https://github.com/SimoneAvogadro).
  6. ## Table of Contents
  7. - [What it does](#what-it-does)
  8. - [Requirements](#requirements)
  9. - [Installation](#installation)
  10. - [Usage](#usage)
  11. - [Repository Structure](#repository-structure)
  12. - [References](#references)
  13. - [Acknowledgments](#acknowledgments)
  14. - [Disclaimer](#disclaimer)
  15. - [License](#license)
  16. ## What it does
  17. | Capability | Description |
  18. |------------|-------------|
  19. | **Fingerprint first (Phase 0)** | Triage an APK/XAPK in seconds — detect the framework (Flutter / React Native / Cordova / Xamarin / native-Kotlin), HTTP stack, obfuscation level and native libs *before* spending time on a full decompile |
  20. | **Decompile** | APK, XAPK, JAR, and AAR files using jadx and Fernflower/Vineflower (single engine or side-by-side comparison) |
  21. | **Recover Kotlin names** | Rebuild original `*Repository` / `*ViewModel` / `*UseCase` class names from R8-obfuscated binaries using Kotlin metadata that R8 cannot strip |
  22. | **Extract APIs** | Retrofit, OkHttp, Volley **and modern Kotlin/KMP stacks: Ktor, Apollo (GraphQL), Koin DI** — endpoints, hardcoded URLs, auth headers, tokens and HMAC request-signing schemes |
  23. | **Trace call flows** | From Activities/Fragments through ViewModels and repositories down to HTTP calls |
  24. | **Analyze structure** | Manifest, packages, architecture patterns |
  25. | **Handle obfuscation** | R8-resistant path/URL extraction plus strategies for navigating ProGuard/R8 output |
  26. ## Requirements
  27. **Required:**
  28. - Java JDK 17+
  29. - [jadx](https://github.com/skylot/jadx) (CLI)
  30. **Optional (recommended):**
  31. - [Vineflower](https://github.com/Vineflower/vineflower) or [Fernflower](https://github.com/JetBrains/fernflower) — better output on complex Java code
  32. - [dex2jar](https://github.com/ThexXTURBOXx/dex2jar) — needed to use Fernflower on APK/DEX files
  33. See `plugins/android-reverse-engineering/skills/android-reverse-engineering/references/setup-guide.md` for detailed installation instructions.
  34. ## Installation
  35. ### From GitHub (recommended)
  36. Inside Claude Code, run:
  37. ```text
  38. /plugin marketplace add SimoneAvogadro/android-reverse-engineering-skill
  39. /plugin install android-reverse-engineering@android-reverse-engineering-skill
  40. ```
  41. The skill will be permanently available in all future sessions.
  42. ### From a local clone
  43. ```bash
  44. git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git
  45. ```
  46. Then in Claude Code:
  47. ```text
  48. /plugin marketplace add /path/to/android-reverse-engineering-skill
  49. /plugin install android-reverse-engineering@android-reverse-engineering-skill
  50. ```
  51. ## Usage
  52. ### Slash command
  53. ```text
  54. /decompile path/to/app.apk
  55. ```
  56. This runs the full workflow: dependency check, decompilation, and initial structure analysis.
  57. ### Natural language
  58. The skill activates on phrases like:
  59. - "Decompile this APK"
  60. - "Reverse engineer this Android app"
  61. - "Extract API endpoints from this app"
  62. - "Follow the call flow from LoginActivity"
  63. - "Analyze this AAR library"
  64. ### Manual scripts
  65. The scripts can also be used standalone:
  66. ```bash
  67. # Check dependencies
  68. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.sh
  69. # Install a missing dependency (auto-detects OS and package manager)
  70. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh jadx
  71. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh vineflower
  72. # Fingerprint an APK/XAPK BEFORE decompiling (Phase 0 triage):
  73. # framework, HTTP stack, obfuscation level, native libs, notable SDKs
  74. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/fingerprint.sh app.apk
  75. # Decompile APK with jadx (default)
  76. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app.apk
  77. # Decompile XAPK (auto-extracts and decompiles each APK inside)
  78. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app-bundle.xapk
  79. # Decompile with Fernflower
  80. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine fernflower library.jar
  81. # Run both engines and compare
  82. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine both --deobf app.apk
  83. # Find API calls — defaults to a full scan across every supported stack
  84. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/
  85. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --retrofit
  86. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --urls
  87. # Modern Kotlin/KMP stacks and obfuscation-resistant extraction
  88. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --ktor # Ktor client
  89. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --apollo # Apollo / GraphQL
  90. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --paths # quoted path literals that survive R8 inlining
  91. ```
  92. ### Kotlin name recovery (R8 deobfuscation)
  93. Most real-world Kotlin/KMP apps ship through R8, so the decompiled classes come
  94. out as `a.b.c`. R8 renames the JVM symbols but **cannot strip the Kotlin
  95. metadata strings** — the Kotlin runtime (reflection, coroutines) needs the
  96. original fully-qualified names at runtime. This skill mines those
  97. `@DebugMetadata` / `@Metadata` annotations to rebuild an `obfuscated → real`
  98. class-name map. On a typical app it recovers ~100 % of the
  99. `*Repository` / `*ViewModel` / `*UseCase` / `*Impl` classes you actually want to
  100. read.
  101. ```bash
  102. # 1. Build the mapping from the decompiled sources
  103. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/recover-kotlin-names.sh output/sources/ output/names/
  104. # → output/names/mapping.tsv, mapping.json, by_package/
  105. # 2. Query it: resolve an obfuscated name, search by real name, or grep
  106. # the sources with each hit annotated with its recovered class name
  107. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/lookup-name.sh output/names/ LoginRepository
  108. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/lookup-name.sh output/names/ -o a.b.c
  109. bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/lookup-name.sh output/names/ --grep 'login' output/sources/
  110. ```
  111. ## Repository Structure
  112. ```text
  113. android-reverse-engineering-skill/
  114. ├── .claude-plugin/
  115. │ └── marketplace.json # Marketplace catalog
  116. ├── plugins/
  117. │ └── android-reverse-engineering/
  118. │ ├── .claude-plugin/
  119. │ │ └── plugin.json # Plugin manifest
  120. │ ├── skills/
  121. │ │ └── android-reverse-engineering/
  122. │ │ ├── SKILL.md # Core workflow (Phase 0–5)
  123. │ │ ├── references/
  124. │ │ │ ├── setup-guide.md
  125. │ │ │ ├── jadx-usage.md
  126. │ │ │ ├── fernflower-usage.md
  127. │ │ │ ├── api-extraction-patterns.md
  128. │ │ │ ├── kotlin-name-recovery.md
  129. │ │ │ ├── third_party_hosts.txt # denylist for first/third-party bucketing
  130. │ │ │ └── call-flow-analysis.md
  131. │ │ └── scripts/
  132. │ │ ├── check-deps.sh # Bash
  133. │ │ ├── check-deps.ps1 # PowerShell
  134. │ │ ├── install-dep.sh
  135. │ │ ├── install-dep.ps1
  136. │ │ ├── decompile.sh
  137. │ │ ├── decompile.ps1
  138. │ │ ├── fingerprint.sh # Phase 0 — pre-decompile triage
  139. │ │ ├── recover-kotlin-names.sh # R8 → real Kotlin class names
  140. │ │ ├── lookup-name.sh # query the recovered name map
  141. │ │ ├── find-api-calls.sh
  142. │ │ └── find-api-calls.ps1
  143. │ └── commands/
  144. │ └── decompile.md # /decompile slash command
  145. ├── LICENSE
  146. └── README.md
  147. ```
  148. ## References
  149. - [jadx — Dex to Java decompiler](https://github.com/skylot/jadx)
  150. - [Fernflower — JetBrains analytical decompiler](https://github.com/JetBrains/fernflower)
  151. - [Vineflower — Fernflower community fork](https://github.com/Vineflower/vineflower)
  152. - [dex2jar — DEX to JAR converter](https://github.com/ThexXTURBOXx/dex2jar)
  153. - [apktool — Android resource decoder](https://apktool.org/)
  154. ## Acknowledgments
  155. Thanks to the contributors who have shaped this skill:
  156. - [@tajchert](https://github.com/tajchert) — Phase 0 fingerprinting, R8-resistant Kotlin name recovery (`recover-kotlin-names.sh`, `lookup-name.sh`), and Ktor / Apollo / Koin / HMAC extraction patterns (#16)
  157. - [@philjn](https://github.com/philjn) — Native Windows / PowerShell support (`check-deps.ps1`, `install-dep.ps1`, `decompile.ps1`, `find-api-calls.ps1`) and split/bundled APK detection in `decompile.sh` (#8)
  158. - [@txhno](https://github.com/txhno) — Migration to the maintained [`ThexXTURBOXx/dex2jar`](https://github.com/ThexXTURBOXx/dex2jar) fork (#12)
  159. - [@muqiao215](https://github.com/muqiao215) — Decompile partial-success handling, Fernflower timeout safeguard, intermediate-artifact directory (#10)
  160. - [@kevinaimonster](https://github.com/kevinaimonster) — Chinese localization (`SKILL.md` discovery keywords) (#4)
  161. ## Disclaimer
  162. This plugin is provided strictly for **lawful purposes**, including but not limited to:
  163. - Security research and authorized penetration testing
  164. - Interoperability analysis permitted under applicable law (e.g., EU Directive 2009/24/EC, US DMCA §1201(f))
  165. - Malware analysis and incident response
  166. - Educational use and CTF competitions
  167. **You are solely responsible** for ensuring that your use of this tool complies with all applicable laws, regulations, and terms of service. Unauthorized reverse engineering of software you do not own or do not have permission to analyze may violate intellectual property laws and computer fraud statutes in your jurisdiction.
  168. The authors disclaim any liability for misuse of this tool.
  169. ## License
  170. Apache 2.0 — see [LICENSE](LICENSE).
  171. The decompilers and other tools this plugin drives (jadx, Vineflower/Fernflower, dex2jar, Apktool, adb, Java) are third-party software, not bundled with the plugin and distributed under their own licenses — see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). Privacy: [PRIVACY.md](PRIVACY.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.