renef-skills

Claude Code 플러그인으로, AI 에이전트가 Android ARM64용 동적 계측 엔진인 renef.io를 올바르게 사용하도록 해줍니다 — 네이티브 및 Java 함수 후킹, 프로세스 메모리 스캔/읽기/쓰기/패치, syscall 추적, 그리고 Lua 5.4 스크립트를 통한 SSL 핀닝/루트 탐지 우회(memfd 인젝션, ptrace 미사용).

이 문서는 운영자 매뉴얼이지 튜토리얼이 아닙니다. 이미 Frida 훅, GameGuardian(gg.*) 치트 또는 게임 해킹 Lua를 작성할 수 있는 에이전트는 개념을 갖고 있습니다 — 단지 renef의 정확한 구문과 워크플로가 부족할 뿐이며, 이를 모르면 renef에서 작동하지 않는 Frida JavaScript, 점으로 구분된 Java 클래스 이름, 절대 훅 주소, retval.replace() 또는 gg.* 호출을 생성합니다. 이 스킬은 에이전트에게 정확한 구문 계약, 자체 스크립트에 대해 실행할 셀프 린트, 작업 → 플레이북 매핑, 다른 도구에서의 변환표, 그리고 복사-붙여넣기 레시피를 제공합니다.

내부 구성

renef-skills/
├── .claude-plugin/
│   └── plugin.json                # plugin manifest
├── CONTRIBUTING.md                # how to contribute VERIFIED findings (no confidential target data)
└── skills/
    └── renef/
        ├── SKILL.md                # operator framing: roles, syntax contract, self-lint, task playbook
        ├── probe.lua               # RUN FIRST — ground-truths the API/behavior of your renef build
        └── references/
            ├── methodology.md      # the investigation loop: solve a NEW bypass yourself
            ├── debugging.md        # renef hides errors — recover them; failure-symptom table; hot-hook race; RASP
            ├── lua-api.md          # full Lua API: Module/Memory/hook/Jni/Java/Thread/File/Syscall/OS/KCov
            ├── cli.md              # commands, flags, connection modes, build/deploy, companion tools
            ├── from-other-tools.md # translate Frida JS + GameGuardian (gg.*) / game-hacking Lua → renef
            ├── recipes.md          # worked examples: SSL/root bypass, WebView, tracing, memory, CTF…
            └── gotchas.md          # pitfalls, doc/runtime discrepancies, troubleshooting

이 스킬은 점진적 공개(progressive disclosure) 방식을 사용합니다: SKILL.md는 간결하게 유지되고(모델은 renef 관련 작업 시 로드함), 더 큰 참조 파일은 필요할 때만 불러옵니다.

설치

표준 Agent Skill(name + description 프론트매터가 있는 SKILL.md)입니다. 요청 시에만 로드됩니다 — 에이전트는 스킬의 설명을 보고 renef 관련 작업이 있을 때만 전체 콘텐츠를 불러옵니다.

하나의 사본, 두 에이전트. Claude Code와 OpenCode 모두 .claude/skills/ 디렉터리를 읽습니다. ~/.claude/skills/renef/(글로벌) 또는 .claude/skills/renef/(프로젝트별)에 설치하면 변환 없이 두 에이전트 모두에서 스킬이 작동합니다.

Claude Code 및 OpenCode(권장)

# Global — available in all your projects, for both Claude Code and OpenCode:
mkdir -p ~/.claude/skills && cp -r skills/renef ~/.claude/skills/renef

# Or per-project:
mkdir -p .claude/skills && cp -r skills/renef .claude/skills/renef

그런 다음 renef 작업을 설명하기만 하면 스킬이 자동으로 활성화됩니다(OpenCode에서는 네이티브 skill 도구를 통해 노출됩니다).

원한다면 OpenCode 네이티브 위치도 작동합니다: .opencode/skills/renef/SKILL.md(프로젝트) 또는 ~/.config/opencode/skills/renef/SKILL.md(글로벌). OpenCode는 추가로 .agents/skills/와 ~/.agents/skills/도 스캔합니다.

Claude Code 플러그인으로 사용

이 저장소를 플러그인 소스(또는 관리하는 마켓플레이스)로 추가하고 renef 플러그인을 활성화하면 번들된 스킬이 자동으로 등록됩니다. (.claude-plugin/plugin.json이 매니페스트입니다.)

기타 에이전트(Cursor, Aider, Cline, Codex, …)

스킬 자동 검색은 아직 보편화되지 않았습니다. 두 가지 이식 가능한 옵션이 있습니다:

1. 에이전트를 이 저장소로 안내 — AGENTS.md(OpenCode/Cursor/Zed를 포함한 많은 에이전트가 읽음)는 프로젝트 방향을 제시하고 skills/renef/SKILL.md를 읽도록 지시합니다.
2. 에이전트의 규칙/지침에 마크다운을 직접 참조 (예: skills/renef/SKILL.md를 포함하는 Cursor .cursor/rules/*.mdc). 콘텐츠는 일반 Markdown입니다.

사용법

작업을 설명하기만 하면 됩니다 — 스킬은 renef 관련 작업에서 트리거됩니다:

• "com.example.app에서 SSL 핀닝을 우회하는 renef 스크립트 작성"
• "이 Frida 스크립트를 renef로 포팅"
• "libapp.so의 네이티브 verify 함수를 후킹하고 인자 로깅"
• "renef-strace를 사용하여 이 앱의 파일 접근 모니터링"

범위 및 윤리

Renef는 Android ARM64를 대상으로 하며, 승인된 보안 테스트, 앱 하드닝 검토, CTF, 그리고 소유했거나 분석이 허용된 소프트웨어의 리버스 엔지니어링을 위한 것입니다. 적용 가능한 법률과 대상 앱의 이용약관을 준수하세요.

크레딧

• renef — @ahmeth4n 제작 — Apache-2.0. 문서: https://renef.io
• 커뮤니티 훅: https://hook.renef.io · r2 플러그인: https://github.com/ahmeth4n/r2renef · 자동 배포 모듈: https://github.com/vichhka-git/magisk-renef

이 플러그인은 문서/지침 전용이며 renef 바이너리를 포함하지 않습니다.