AGENT SKILL

abhay2008-ctf-re-bridge

暂无简介

License 许可
MIT
最近更新
2026-11-15
Stars
★ 81
Forks
17

02 资源文件 3

03 SKILL.md 正文

CTF RE Bridge — binary to decompilation loop

r2 answers "what is this" in seconds. Ghidra answers "what does it do" in minutes. Python answers "now run it my way". Use all three, in that order. Do not start Ghidra before r2 triage tells you the binary is worth it.

0. Environment (this machine's facts)

  • r2 / r2pm: /opt/homebrew/bin (radare2 6.2.6). r2mcp binary: ~/.local/share/radare2/prefix/bin/r2mcp, invoked as r2pm -r r2mcp (default mode, ~32 tools). NOTE: -R/-m modes drop open_file/analyze — useless for real work. Default mode is safe enough: dangerous run_* tools need -r, permissive mode needs -p; neither is enabled.
  • Compiler shims (cc/gcc/make in /usr/bin) are broken Xcode stubs — no Command Line Tools. If you must compile C: toolchain clang at /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang with --sysroot=<MacOSX.sdk>, make from brew install make (gnubin on PATH), git from /opt/homebrew/bin. Rebuilding r2mcp needs all three (see build log in the phase-2 notes).
  • MCP entry r2 in .agents/mcp.json sets PATH so the server finds r2mcp.
  • Ghidra: /opt/homebrew/share/ghidra_12.1.4_PUBLIC (GHIDRA_INSTALL_DIR), GhidraMCP 2.0 extension installed, decompiler natives built via ./support/gradle/gradlew buildNatives with JAVA_HOME=/opt/homebrew/opt/openjdk@21. GhidraMCP is pinned to Ghidra 12.1.4 — do not "upgrade" Ghidra without checking the extension release first.
  • Python kit: ctf-solver/.venv/bin/python has lief, capstone, keystone (needs brew keystone dylib + setuptools for distutils), unicorn. Verify: python -c "import lief,capstone,keystone,unicorn".

1. Triage (r2, < 60 seconds)

open_file <abs path>  ->  analyze  ->  show_info

Read show_info first: arch/bits/endian, format, stripped?, packed?, canary/NX/PIE. Then in parallel: list_strings (regex flag|key|pass|secret|http), list_imports (ptrace, syscall, mmap, crypto imports = anti-debug/VM/custom-crypto smells), list_entrypoints, list_functions {"count": true}.

Decision:

  • < 50 functions, unstripped C → stay in r2, decompile each interesting function.
  • C++ / Objective-C / Rust / Go, or > 200 functions → Ghidra (§3).
  • Entropy high + tiny import table + UPX/MEzzo strings → packer: unblob the outer layer or find the unpacking stub first; do not waste Ghidra time on packed code.
  • Firmware/blob (no headers) → unblob carve first, then loop per extracted ELF.

2. r2 deep loop

list_functions (paginate: max_length 50) → decompile_function (pdc, address as 0x...) → disassemble_function when pdc output is unclear → xrefs_to on interesting constants → lookup_address on mystery pointers. Rename globals as you learn them (rename_function is available in default mode — use it; names compound across turns).

Custom crypto / encoding: lift the transform into Python with capstone (Cs(CS_ARCH_X86, CS_MODE_64)) to confirm semantics, then reimplement decrypt in pure Python. Never hand-simulate more than ~20 instructions.

3. Ghidra headless (when r2 is not enough)

GHIDRA_INSTALL_DIR=/opt/homebrew/share/ghidra_12.1.4_PUBLIC \
uvx --python 3.13 --from "ghidra-mcp[headless] @ git+https://github.com/LaurieWired/GhidraMCP" \
  ghidra-mcp --headless --binary /abs/path/to/binary --project /tmp/ghidra-proj

Use for: virtual-function-heavy C++, exception-flow, structure recovery, type propagation. --project DIR persists renames between runs. If it errors about the decompiler binary, natives were not built — rerun buildNatives (§0).

GUI fallback: only if headless blocks on something exotic. GUI kills agent autonomy — prefer to extract and emulate instead (§4).

4. Emulation & patching (the hard-binary toolkit)

  • Custom VM / bytecode: map sections with LIEF, emulate the handler loop in unicorn, dump the trace. This is the highest-yield hard-RE pattern in this workspace.
  • Assemble patches / shellcode: keystone (Ks(KS_ARCH_X86, KS_MODE_64).asm(b"...")) — verified working, e.g. mov rax,0x4141 → 48c7c041410000.
  • Parse/patch headers: LIEF (lief.parse), rebuild and test. Keep the original (cp binary binary.orig) — every patch gets a diff check (r2 -Q -c 'pv' ... or sha256 before/after).

5. Failure branches

  • r2mcp won't start / r2mcp: command not found: r2pm -l | grep r2mcp empty → rebuild per §0 toolchain notes; non-empty but not on PATH → check R2PM_BINDIR (~/.local/share/radare2/prefix/bin) is installed via make user-install.
  • Stripped + no strings: list_all_strings (whole-binary scan) → search for magic constants → entrypoint-first analysis (list_entrypoints, decompile from there).
  • Anti-debug (ptrace, is_debugger): patch the check in a COPY (LIEF or r2 w in a scratch copy — never the evidence original), or emulate the guarded region in unicorn.
  • Go/Rust binaries: function count explodes — filter list_functions {"filter": "main\\."} and read from main.main.
  • APK native libs: extract .so from the APK (unzip), treat as ELF; Java/Kotlin layer needs jadx (not installed — Phase 2 covers native only, say so and stop).

Verify the stack

r2 -v && r2pm -r r2mcp -t | wc -l
./ctf-solver/.venv/bin/python -c "import lief,capstone,keystone,unicorn; print('pykit ok')"
ls /opt/homebrew/share/ghidra_12.1.4_PUBLIC/Ghidra/Features/Decompiler/os/  # want mac_* dir

04 同仓库更多 Skills

jiayaoqijia
jiayaoqijia/cryptoskill

troves

Deposit and withdraw from Troves DeFi yield vault strategies on Starknet. View available strategies, check positions, and manage vault deposits. Use this skill when the user mentions Troves, vault, yield vault, DeFi vault, strategy, yield farming, vault deposit, vault withdraw, earning yield through vaults, passive yield strategies, or wants to deposit into or withdraw from a yield strategy — even if they don't say "Troves" explicitly.

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

trade

Swap tokens on Starknet via Fibrous DEX aggregator. Supports per-provider selection (avnu, ekubo, or auto to race all). Use this skill when the user wants to swap, exchange, trade, convert, buy, or sell one token for another on Starknet. Also use when the user asks about token prices, exchange rates, DEX routing, best swap route, or wants to check how much they would receive for a given amount — even if they don't explicitly say "swap".

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

staking

Stake, unstake, claim, and compound rewards for STRK, WBTC, tBTC, SolvBTC, and LBTC on Starknet. View validators, pools, and staking positions. Use this skill when the user mentions staking, delegating, validators, staking pools, rewards, compounding, unstaking, earning yield, passive income on crypto, or wants to earn on their STRK or BTC tokens — even if they don't say "stake" explicitly.

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

send

Send STRK, ETH, or any ERC-20 token to a Starknet address. Supports simulation (dry-run) before execution. Use this skill when the user wants to send, transfer, pay, tip, or move tokens to another wallet address on Starknet. Also trigger when the user mentions sending funds to someone, making a payment, transferring assets, or moving crypto to a specific address — even if they just say "pay 10 STRK to 0x...".

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

portfolio

View a comprehensive DeFi portfolio dashboard and optimize portfolio allocation via automated rebalancing. Use this skill when the user wants an overview, summary, dashboard, total value, net worth, portfolio rebalancing, target allocation, or wants to see all their DeFi positions across Starknet at once. Also trigger when the user asks "what do I have", "show me everything", "how much am I worth", "my positions", "my investments", "rebalance my portfolio", "I want 50% ETH", "optimize my holdings", or any request for a holistic view of their Starknet holdings — even if they don't explicitly say "portfolio".

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

multi-swap

Execute multiple token swaps in a single Starknet transaction via Fibrous (default). Supports per-provider selection (avnu, ekubo, or auto to race all). Supports 2-3 swap pairs bundled into one multicall. Use this skill when the user wants to swap multiple token pairs at once, do batch swaps, execute several trades simultaneously, perform parallel swaps, or do bulk trading in one transaction. Also trigger when the user mentions "two swaps", "three swaps", "swap X and Y at the same time", or wants to convert multiple tokens in a single call.

★ 81