Guide · Agent skill
How to use the Reverse Engineering agent skill (reverse-engineering)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Reverse Engineering Playbook is an agent skill: a folder of instructions and reference notes that a coding agent loads when it needs to work out how a compiled, obfuscated, packed or virtualized program behaves. This guide is for people who have never used agent skills and want to install this one, ask for help with a binary, APK, WASM module or firmware image, and know what it needs from their machine. By the end you will know where to put the files, how to phrase a request so the skill triggers, and what safety limits to keep in mind.
Quick start
- 1Download and unzip the skill. Download the ZIP from this page and unzip it so the folder contains SKILL.md.
- 2Place the folder. Move it into ~/.claude/skills/ for all projects, or into the project's .claude/skills/ folder for one project. In the Claude apps, upload it under Settings → Capabilities → Skills.
- 3Install the prerequisites. Install the Python packages and system tools listed in the skill's prerequisites, using pip and apt or Homebrew as appropriate.
- 4Confirm your sandbox. Make sure the target sample is a local, authorised file inside an isolated environment before you start.
- 5Make a request. Describe what you want to understand about the file and name it, without asking for exploitation of a known bug.
- 6Review the findings. Ask the agent to summarise its evidence and explain how the target works.
What the reverse-engineering skill makes the agent do
Once installed, the agent follows a structured reverse engineering workflow when you ask it to figure out how a binary, APK, WASM module, firmware image, custom VM or anti-debug protected program works. The workflow runs in four stages: triage, static analysis, dynamic analysis and synthesis.
The skill is aimed at understanding a target that is intentionally hard to read. It is not meant for exploiting a bug that is already understood. Its description says to use the separate pwn skill once the vulnerability is known and only exploitation remains.
- Triage: find out what the target is and where to start.
- Static analysis: read the code without running it.
- Dynamic analysis: observe the target while it runs.
- Synthesis: combine the findings into an explanation of how the target works.
Install the skill from the ZIP
Download the ZIP for the skill from this page and unzip it. The skill folder should contain SKILL.md along with its reference files. Then choose one of two locations depending on how you want to use it.
For a personal install that applies across your projects, unzip it into ~/.claude/skills/. To limit it to one project, unzip it into that project's .claude/skills/ folder instead.
If you use the Claude apps rather than a local agent, open Settings, go to Capabilities, and upload the skill under Skills.
- Personal (all projects): ~/.claude/skills/
- Single project: the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload
Install the tools the skill relies on
The skill tells the agent which tools to reach for, but those tools must exist on your machine. The skill's prerequisites list Python 3 packages to install with pip, plus system tools installed through apt on Linux or Homebrew on macOS. Ghidra, pwndbg and pycdc are optional.
Run the install commands from the skill's prerequisites section. If a tool is missing, the skill says to call its bootstrap step rather than guess a path.
- Python packages: frida-tools, angr, qiling, uncompyle6, capstone, lief, z3-solver
- Linux (apt): gdb, radare2, binutils, strace, ltrace, apktool, upx
- macOS (Homebrew): gdb, radare2, binutils, apktool, upx, ghidra
- Optional: pwndbg, pycdc built from source, Ghidra
pip install frida-tools angr qiling uncompyle6 capstone lief z3-solver
apt install gdb radare2 binutils strace ltrace apktool upxTrigger the skill with natural requests
You do not need a special command. Describe the job in plain terms and name the target file. The agent decides whether the request matches the skill's scope from its description.
Good requests say what you want to understand, not how to break it. Mention the file type if it helps, for example a binary, APK, WASM module, firmware image or custom bytecode VM. If the vulnerability is already known and you only need an exploit, ask for that directly; the skill will point you to pwn instead.
- "Work out how this ELF binary checks my input. The file is crackme1 in this folder."
- "This APK seems to hide its API key. Analyse how the key is built."
- "This firmware image has a custom VM. Explain how its bytecode is dispatched."
- "This binary detects a debugger and exits. Find the checks and explain them."
What the skill needs and what it does on your machine
The skill declares that it runs scripts and uses the network. Its scope assumes an authorised local environment such as a CTF challenge, a wargame, a training exercise, or a local sample in an isolated lab. Its description says not to use it on live malware or unknown samples outside an isolated sandbox, because it may run tools against the target.
By default the skill prefers offline analysis and avoids contacting outside services unless you choose a branch that needs them. It is written not to modify original files or run state-changing actions except on a copy inside the case workspace. Internet access is still needed when installing tools.
- Work on copies of samples, not originals.
- Keep unknown or suspicious samples inside an isolated sandbox or VM.
- Expect the agent to run scripts and tools against the target.
- Internet access is required for installation steps.
Tips for getting useful results
Give the agent a clear entry point. If you know the input format, the function name, a string in the output, or the command that produces the first prompt, include it. The skill's triage stage works best with a starting point.
Ask for the explanation you need at the end, such as the algorithm, the key, or the flow of a validation routine. The synthesis stage is where findings are gathered together.
- Name the file and the platform (x86-64 Linux, Android, WASM).
- Say what you already tried so the agent does not repeat it.
- Ask for a summary of evidence, not only a final answer.
What people use it for
- Working through a CTF crackme that checks a password in a binary.
- Understanding how an APK builds or hides a value at runtime, in a lab.
- Explaining a custom bytecode VM found in a firmware image you are authorised to inspect.
- Mapping the anti-debug checks in a training challenge so you can study them.
Frequently asked questions
How do I install the reverse engineering agent skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for all projects, or into a project's .claude/skills/ folder for one project. In the Claude apps, upload it under Settings → Capabilities → Skills.
What do I need before using this skill?
You need Python 3, the pip packages frida-tools, angr, qiling, uncompyle6, capstone, lief and z3-solver, and system tools such as gdb, radare2, binutils, strace, ltrace, apktool and upx. Ghidra, pwndbg and pycdc are optional. Internet access is needed to install the tools.
Is the reverse engineering skill free to use?
The skill is released under the MIT licence, as stated in its SKILL.md. The tools it installs have their own licences, which you should check individually.
Which tools does the skill use?
The skill references Ghidra, radare2, GDB, Frida, angr, Qiling and other tools, and reaches for them according to the task. Install the ones you expect to need from its prerequisites list.
Can I use this skill on malware?
Not on live malware or unknown samples outside an isolated sandbox. The skill assumes an authorised local environment and may run tools against the target.
Why won't the skill help me exploit my bug?
Its scope covers understanding a hard-to-read target before exploiting or solving it. When the vulnerability is already understood and only exploitation remains, the skill says to use the pwn skill instead.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits students working on CTF crackmes, wargames and reversing training, and security researchers analysing local samples in an isolated lab. It also helps developers trying to understand a compiled binary or firmware they are authorised to inspect. If your job is pure web testing, log or disk forensics, standalone crypto, or exploiting a bug you already understand, pick a different skill.
Download the skill