hypnguyen1209/offensive-claude / skills/reverse-engineering
reverse-engineering
VerifiedUse when reverse-engineering a binary or firmware — static triage + decompilation (Ghidra/IDA/Binary Ninja), dynamic instrumentation (GDB/Frida 17/angr), anti-reversing & packer bypass, OLLVM/VM deobfuscation, UEFI/BIOS RE & Secure Boot research, patch-diffing for n-days
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.4 KB |
| references/anti-reversing-bypass.md | markdown | 7.7 KB |
| references/coverage-reachability.md | markdown | 3.2 KB |
| references/deobfuscation.md | markdown | 8.6 KB |
| references/dynamic-instrumentation.md | markdown | 7.9 KB |
| references/firmware-uefi.md | markdown | 8.6 KB |
| references/patch-diffing-protocol.md | markdown | 8.4 KB |
| references/rr-time-travel.md | markdown | 3.1 KB |
| references/static-triage-decompilation.md | markdown | 8.2 KB |
| scripts/antidebug_unhook.py | script | 5.9 KB |
| scripts/cve_diff.py | script | 9.6 KB |
| scripts/deflatten_triton.py | script | 5.9 KB |
| scripts/frida_universal.js | script | 8.3 KB |
| scripts/ghidra/DecompileToC.java | other | 1.8 KB |
| scripts/patchdiff_fetch.py | script | 5.3 KB |
| scripts/proto_infer.py | script | 7.1 KB |
| scripts/rr_root_cause.sh | script | 3.3 KB |
| scripts/string_decrypt_emu.py | script | 6.0 KB |
| scripts/triage.py | script | 9.2 KB |
| scripts/uefi_triage.py | script | 6.2 KB |
scripts/rr_root_cause.sh
View on GitHub#!/usr/bin/env bash
# rr_root_cause.sh — deterministic record/replay root-cause for a crashing input.
#
# Records the crashing run with rr (Mozilla time-travel debugger), then drives a reverse-debug
# session to the fault and emits two machine artifacts the finding harness understands:
# - a function-trace log (trace_proof: validate_findings.py checks the vuln function appears), and
# - a root-cause summary (faulting instruction + a reverse-continue note).
#
# Linux-only (needs rr + gdb + CAP_SYS_PTRACE; see .devcontainer/). DEGRADES GRACEFULLY: if rr/gdb
# are absent (e.g. on a non-Linux host) it skips with a notice instead of failing the pipeline.
#
# Usage:
# rr_root_cause.sh <target> [args...] # the crashing invocation (e.g. ./vuln poc_input)
# OUT=results/ rr_root_cause.sh ./vuln @@ # @@ replaced by $CRASH_INPUT if set
#
# Env: OUT (output dir, default ./rr-out), CRASH_INPUT (file substituted for @@), FUNC (vuln function
# name to confirm in the trace; default: auto from the crashing frame).
set -euo pipefail
HERE="$(cd "$(dirname "$0")" && pwd)"
# shellcheck source=/dev/null
source "$HERE/../../coding-mastery/scripts/lib.sh"
OUT="${OUT:-./rr-out}"
TARGET="${1:-}"
[ -z "$TARGET" ] && { _err "usage: rr_root_cause.sh <target> [args...]"; exit 2; }
shift || true
_need rr "rr (https://rr-project.org); apt install rr — and set kernel.perf_event_paranoid=1" || exit 0
_need gdb "gdb" || exit 0
mkdir -p "$OUT"
ARGS=()
for a in "$@"; do
if [ "$a" = "@@" ] && [ -n "${CRASH_INPUT:-}" ]; then ARGS+=("$CRASH_INPUT"); else ARGS+=("$a"); fi
done
_log "recording crashing run under rr: $TARGET ${ARGS[*]:-}"
# _RR_TRACE_DIR keeps the trace inside the engagement workspace (not ~/.local/share/rr).
export _RR_TRACE_DIR="$OUT/rr-trace"
rm -rf "$_RR_TRACE_DIR"
if ! rr record -n "$TARGET" "${ARGS[@]}" >"$OUT/record.log" 2>&1; then
_warn "target did not crash (or rr record failed) — see $OUT/record.log; nothing to root-cause"
fi
# Replay: stop at the fault, capture the crashing frame, then reverse-continue one step for the cause.
GDB_CMDS="$OUT/rr.gdb"
cat > "$GDB_CMDS" <<'GDB'
set pagination off
set logging file rr-out/gdb.log
set logging on
continue
echo \n==== CRASHING FRAME ====\n
bt 12
echo \n==== REVERSE STEP (where the bad value was set) ====\n
reverse-stepi
info registers rip rsp
echo \n==== FUNCTION TRACE (entered functions on the path) ====\n
GDB
_log "replaying to fault + reverse-stepping for root cause"
# -o feeds the gdb script; rr replay is deterministic so this is reproducible.
rr replay -o "-x $GDB_CMDS -batch" >"$OUT/replay.log" 2>&1 || _warn "replay ended early — see $OUT/replay.log"
# Emit the trace_proof artifact: the functions seen on the crashing run (rr can list them).
TRACE="$OUT/trace.txt"
rr replay -a >"$TRACE" 2>/dev/null || cp "$OUT/replay.log" "$TRACE"
FUNC="${FUNC:-$(grep -m1 -oE '#[0-9]+ +0x[0-9a-f]+ in +[A-Za-z_][A-Za-z0-9_]*' "$OUT/gdb.log" 2>/dev/null | awk '{print $NF}')}"
_ok "root-cause artifacts in $OUT/:"
_ok " trace_proof : $TRACE (function: ${FUNC:-<unknown - set FUNC=>})"
_ok " summary : $OUT/gdb.log (crashing frame + reverse step)"
cat <<JSON
{"trace_proof": {"log": "$TRACE", "function": "${FUNC:-FILL_IN}"},
"note": "rr deterministic replay; reverse-stepi shows where the bad value was set (see gdb.log)"}
JSON
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |