what you get
- 41 structured routing rules (R0–R40)
- Client-independent specialized skills and optional adaptation layers
- Native tool index and per-task bootstrapped toolchains
- Scope, Timeline, Evidence, Finding, Review evidence chain
You only need to let AI read README_AI.md completely; environment identification, initialization, routing, tool checking, case and verification are all automatically completed by AI.
reverse-skill is a client-agnostic security task routing package that is not tied to OpenCode, Codex, Claude Code, Cursor, or other single platforms. During normal use, you do not need to execute the commands on this page one by one: give the warehouse to AI and let it read it completely README_AI.md That’s it.
README_AI.md The platform must then be automatically detected, the tool index refreshed, the rule chain loaded and the task continued; only authorizations, credentials, commercial licenses or external status changes require your confirmation.Please read README_AI.md completely and strictly follow Section 0 to automatically complete the initialization and checking of the current environment.
Please automate normal steps; only ask me if you need my authorization, credentials, commercial license, or will change external state.
After completion, report the identified platform, rule chain, and tool index status, and then continue processing the authorization tasks I will give next.
I don't need to manually copy and execute the process commands shown on the tutorial page.offline, external connections are prohibited.lab_only Or clear game goals.authorized_target_only。case-init, ensure auth.status=granted and network_profile Ready. When not ready, only read-only planning and preparation can be performed.Finish reading README_AI.md Then, AI will automatically complete this section: identifying the platform and installation path, checking the basic environment, generating a native tool index, loading the rule chain, and bootstrapping the tool on demand when the task really requires it. The following commands are used to show what it is doing and how to check if it fails, rather than requiring the user to run them one by one.
AI selects Windows, Kali, normal Linux or macOS paths based on the actual system and performs corresponding checks on its own. When basic dependencies are missing, it should first determine whether it can be safely installed automatically instead of asking users to copy the entire command.
git --version
powershell -NoProfile -Command "$PSVersionTable.PSVersion"
python --version
node --versiongit --version
bash --version
python3 --version
node --versionIf the warehouse is already open, the AI directly retrieves the README_AI.md The real root directory is deduced from the location, and the user does not need to clone repeatedly. Only choose the stable version if you have not yet obtained the project. v1.0.1 or main。
git clone --branch v1.0.1 --depth 1 https://github.com/zhaoxuya520/reverse-skill.git
cd reverse-skill
git status --shortgit clone https://github.com/zhaoxuya520/reverse-skill.git
cd reverse-skill
git status --shortgit status --short By default, there is no output, indicating that the newly cloned workspace is clean. If there are local modifications, confirm whether these modifications need to be retained before updating.README_AI.md Explicitly require the index to be refreshed on the first run. AI should generate itself skills/tool-index.md with skills/tool-index.json, record the tools and paths that are actually available on the current machine, and cannot require users to copy the results of other machines.
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/refresh-tool-index.ps1
Get-Item skills/tool-index.md, skills/tool-index.jsonbash skills/scripts/refresh-tool-index.sh
ls -l skills/tool-index.md skills/tool-index.jsonbash kali/scripts/refresh-tool-index.sh
ls -l skills/tool-index.md skills/tool-index.jsonOnly when the user requests an update, the AI checks the workspace first and retains existing changes; the mainline only accepts fast-forward updates. When local modifications or branch differences are discovered, AI should first report the differences and not allow users to blindly execute override commands.
git status --short
git fetch --tags --prune
git pull --ff-onlyAfter completing the configuration, AI actively reports the platform, actual path, rule chain, tool index and missing capabilities. If the authorized task has not been received at this time, it will stop in the preparation stage and will not access any external targets.
case-init、auth.status=granted、network_profile, and does not tie the core to a single client.kali/README-kali.md;Ubuntu / Debian → docs/platforms/linux.md;macOS → docs/platforms/macos.md. Users do not need to decide in advance which copy to read.tool-index.md, only necessary capabilities for which the current PRIMARY Skill installation status is "Not Found"; ask the user again when a license or additional authorization is required.Access does not require users to install a special plug-in or manually configure the entire set of routes. Usually just open the repository with the code agent and let it read it in full README_AI.md;Then platform identification, rule loading and tool indexing are all automatically completed by AI.
| client | Open method | must read | Things to note |
|---|---|---|---|
| Codex | Open the repository as a workspace | AGENTS.md、README_AI.md、RULES.md | Automatically route by project directive; do not copy rules to global prompts |
| Claude Code | Start from the repository root directory | README_AI.md、RULES.md | Request read-only check before starting Case |
| Cursor / Cline / Windsurf | Open Folder Open the warehouse | README_AI.md、RULES.md | Make sure the Agent can read the entire skills directory |
| OpenCode | Use the warehouse as project | README_AI.md、RULES.md | Optional use of project-level skills.paths; must not be a core dependency |
| Other clients | Using Project Commands/Skill Portal | README_AI.md、RULES.md | Just be able to read the file and run the native script |
Agent passes README_AI.md Deduce the Skill Root from its real location and confirm that it can be accessed RULES.md with skills/。
The Agent automatically selects platform documents, refreshes the index, reads RULES and structured routing according to README_AI section 0, and should not stop after just summarizing the README.
README_AI.md It is only used to check the rule chain when the system starts; there is no need to send a second set of configuration prompts during normal first startup.You are now at the root of the reverse-skill repository.
Please read README_AI.md and RULES.md and list the complete file chain from "User Tasks" to "PRIMARY Skill".
Then explain when case-init, tool-index, bootstrap and case-review are used respectively.
Read-only check, no external network actions are performed.routing.json / MASTER-ROUTING.md → case-init → PRIMARY SKILL.md → tool-index / bootstrap → Evidence → Case Review。AI can call routing entries without accessing external targets, verify that the output contains PRIMARY, confidence, and route-scope.md. Commands are selected and executed by the AI.
# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/master-route.ps1 -Hint "Android APK reinforcement decompilation"
# Linux / macOS / Kali
bash skills/scripts/master-route.sh --hint "Android APK reinforcement decompilation"skills/apk-reverse/SKILL.md. If it falls into R0, first confirm the current branch,routing.json Works fine with Python 3 (required for Bash Router).Not modified when switching clients routing.json. The client only changes the loading method of project instructions, and the routing results remain consistent with the Case structure.
skills/config/routing.json It is the only source of truth for routing, and the client only does loading and calling.After the initialization is completed, the user only needs to provide the task, authorization basis, allowed scope, prohibited actions and expected delivery. AI will automatically complete routing, Case initialization, Scope structuring and Guard; the commands in this section just unfold the automatic process for you to see. This tutorial uses a reserved example domain name https://lab.example/, will not connect to the real target.
The task description contains at a minimum the type of goal, basis for authorization, scope of permissions, prohibited actions, and deliverables. The more specific the description, the more reliable the routes and scopes automatically generated by AI.
Target: The company's own testing environment https://lab.example/.
Authorization basis: Internal work order SEC-001; only this domain name is allowed, DoS, phishing and access to real user data are prohibited.
Task: Review the request signature and front-end JS call chain of the login interface.
Delivery: Reproduction steps, evidence, Finding, repair recommendations, and Case Review report.AI first reads, analyzes text and writes out route-scope.md, the target will not be accessed. Windows and Bash use the same routing.json。
# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/master-route.ps1 -Hint "Authorized front-end signature JS reverse encryption parameter analysis"
# Linux / macOS / Kali
bash skills/scripts/master-route.sh --hint "Authorized front-end signature JS reverse encryption parameter analysis"js-reverse, confidence is medium, the secondary usually contains a generic inverse; this is a normal result of multiple keyword hits and should be viewed both in the routing file and the full matrix.AI extracts authorization, assets and network modes from the tasks provided by the user, automatically selects the platform entrance and runs initialization; when there is insufficient information, it asks first and cannot make up the authorization fields by itself.
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/case-init.ps1 `
-Hint "Authorized front-end signature JS reverse encryption parameter analysis" `
-CaseName "demo-js-signature" `
-AuthGranted `
-AuthBasis "written_contract" `
-EvidenceOfAuth "internal ticket SEC-001" `
-TargetUrl "https://lab.example/" `
-NetworkProfile "authorized_target_only"bash skills/scripts/case-init.sh \
--hint "Authorized front-end signature JS reverse encryption parameter analysis" \
--case-name "demo-js-signature" \
--auth-granted \
--auth-basis "written_contract" \
--evidence-of-auth "internal ticket SEC-001" \
--target-url "https://lab.example/" \
--network-profile "authorized_target_only"work/demo-js-signature/, which contains at least scope.md、timeline.md、workitems.md、README.md、evidence/、notes/ and report/。The AI automatically checks the table below and confirms to the user the authorization boundaries that cannot be derived, in particular prohibited actions, activity types and data processing constraints. The user is responsible for confirming the true authorization, and the AI is responsible for writing and verifying the structure.
| Field | Examples | Judgment criteria |
|---|---|---|
| auth.status | granted | There must be traceable authorization basis and cannot be inferred from the Agent. |
| auth.evidence_of_auth | internal ticket SEC-001 | Write work orders, contracts, contest pages or proof of ownership |
| in_scope.assets | https://lab.example/ | Itemize assets; don’t use vague “company-owned domain names” |
| in_scope.activities | recon, reverse, report | List only permitted actions |
| out_of_scope.activities | DoS, phishing, data exfil | Explicitly prohibited items |
| network_profile.mode | authorized_target_only | The network can only go to the in_scope list |
| signoff.ready_for_act | true | It becomes true only when all the aforementioned fields are completed. |
The AI automatically performs a Guard before any command to access the target. Only continue with exit code 0; exit code 2 will stop at the preparation stage and explain what is missing. You cannot leave the Guard command to the user and then continue directly.
# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/case-guard.ps1 -CaseRoot "work/demo-js-signature"
# Linux / macOS / Kali
bash skills/scripts/case-guard.sh --case-root "work/demo-js-signature"CASE-GUARD OK. If prompted with auth, network, assets or ready_for_act issues, return to scope.md Correction; do not use --force / -Force Bypass normal workflow.After Guard passes, AI reads skills/js-reverse/SKILL.md of ACTION REQUIRED, tool requirements, stop conditions, and product format, then continue execution within the Scope.
bash skills/scripts/case-init.sh \
--hint "Analyze the encryption protocol of your own APK" \
--case-name "demo-apk-offline" \
--preset offline-sample \
--sample "./samples/app.apk"-AuthGranted -AuthBasis own_system -InScopeAssets "C:\samples\app.apk" -NetworkProfile offline initialization. Entrances will be kept conservatively ready_for_act=false; After AI confirms file ownership, out_of_scope and "no external connections" to the user, it then updates the Scope and automatically runs Case Guard, without the user having to edit manually.The following shows the complete link of AI automatically executed in the background to facilitate auditing and troubleshooting. During normal use, users do not need to call these scripts step by step; the AI must retain the input, output, and intermediate products of each step and pause when user authorization is required.
routing.json Score based on task semantics and select PRIMARY. The output is saved in work/master-route-*/route-scope.md, so you can look back and see why you chose that Skill at that time.
case-init Create Scope, Timeline and Work Item;case-guard It is the machine check before ACT.
AI reads the Skill's ACTION REQUIRED and necessary references, records the plan, tool requirements, stopping conditions, and expected evidence, and runs the scan directly without skipping gates.
AI open skills/tool-index.md, only processes Required tools of the current Skill. When the status is ready, use the absolute path in the index directly; when the status is missing and automatic installation is allowed, run bootstrap again.
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/bootstrap-reverse.ps1 -Capability @('jadx')
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/refresh-tool-index.ps1# First check the supported capability names
bash skills/scripts/bootstrap-reverse.sh --list
# Only install the capabilities required for the current task
bash skills/scripts/bootstrap-reverse.sh jadx
bash skills/scripts/refresh-tool-index.shbash kali/scripts/bootstrap-reverse.sh jadx apktool frida jshookmcp
bash kali/scripts/refresh-tool-index.shtool-index.md It should change from "Not Found" to "Discovered" and give the executable path. If still not found, don't guess the path; look at bootstrap's failure output and manualInstallHint.AI writes for every important action timeline.md: time, role, command or reference, result summary, artifact, evidence ID, and next step; failed attempts are also retained.
The AI records observation time, source, recurrence command, original excerpt, severity, and status and does not just output untraceable conclusions.
Set-Content -Path "work/demo-js-signature/notes/E-001-excerpt.txt" -Value "signature() calls buildNonce() before request dispatch"
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/append-evidence.ps1 `
-CaseRoot "work/demo-js-signature" `
-Id "E-001" `
-Title "Request signature call chain observed" `
-ReproCommand "Open app.js and trace signature() call sites" `
-Severity "info" `
-Status "observed" `
-RawExcerptFile "work/demo-js-signature/notes/E-001-excerpt.txt"evidence/E-001.md, updated at the same time evidence/INDEX.md. Special characters or multi-line content are used first -RawExcerptFile, to avoid command line quotes from corrupting fields.AI only promotes conclusions that reference one or more Evidence IDs to Findings, describing impact, confidence, scope, and validation status.
| Status | meaning | Can you enter the report? |
|---|---|---|
| observed | The original phenomenon has been documented but has not yet been fully explained | It can be used as evidence and does not directly draw conclusions about loopholes. |
| candidate | There are reasonable assumptions that still need to be reproduced or eliminated. | Can only be marked "to be verified" |
| validated | Stable reproduction within Scope with evidence chain | Can enter formal Finding |
| false_positive | has been proven to be untenable | Keep audit records and avoid risks of inaction |
AI automatically performs strict and hash verification before delivery; the reviewer only reads the Case and does not rewrite the original evidence. Any errors are blocking items.
#Look at the human readable results first
python3 skills/case-review/scripts/review_case.py work/demo-js-signature --format markdown
# Strict inspection and hash verification before delivery
python3 skills/case-review/scripts/review_case.py work/demo-js-signature --verify-hashes --strictpython, can be python3 Replaced with the Python 3 path recorded in the index.AI writes formal report report/, including scope, methods, evidence citations, Finding, limitations and repair suggestions; only desensitized and reusable experiences are written into the field-journal.
These examples show how AI will automatically route, initialize, and review tasks after receiving authorization, rather than requiring users to copy terminal commands. Users only need to provide real assets, authorization basis, allowed scope and delivery targets.
| target | ./samples/app.apk | Confirm file ownership and hash, original file is saved read-only |
| expected route | R1 → apk-reverse | Keywords include APK / jadx / smali |
| allow | Unpacking, static analysis, local simulation | If you need a real Hook, add the equipment Scope separately. |
| prohibited | Public network request and modify original samples | Output into Case evidence / notes |
sha256sum ./samples/app.apk
bash skills/scripts/master-route.sh --hint "Own APK jadx smali static analysis"
bash skills/scripts/case-init.sh --hint "Static analysis of own APK" --case-name apk-local-001 --preset offline-sample --sample ./samples/app.apk
bash skills/scripts/case-guard.sh --case-root work/apk-local-001skills/apk-reverse/SKILL.md. All toolpaths start from tool-index.md Obtain; if jadx is missing, bootstrap again.| target | http://10.10.10.20/ | Example address; confirm that it belongs to the isolation experimental network before actual use. |
| expected route | pentest-tools Or more specifically Web Skill | Subject to task semantics, no tools are required to be specified |
| allow | Verification of limited ports and rates | Specify timeout, concurrency, and time window in Scope |
| prohibited | Beyond the experimental network, DoS, real credential attacks | Stop immediately if out-of-border assets are discovered |
bash skills/scripts/case-init.sh \
--hint "Isolated Lab Web Security Verification" \
--case-name "lab-web-001" \
--preset own-system \
--target-url "http://10.10.10.20/" \
--network-profile "lab_only"
bash skills/scripts/case-guard.sh --case-root work/lab-web-001scope.md Assets can only contain lab addresses, and the network mode is lab_only. Any scan parameters should be written into the work item before execution.python3 skills/case-review/scripts/review_case.py work/case-001 --format markdown
python3 skills/case-review/scripts/review_case.py work/case-001 --verify-hashes --strict
python3 skills/case-review/scripts/review_case.py work/case-001 --format jsonscope.* Error, then handle Evidence / Finding Path; warning can be explained but must be stated in the delivery record, error must be cleared.Assets and Attribution: <Local File/Lab URL/Written Authorization Target>
Authorization evidence: <work order, contract, competition page, proof of ownership>
Allowed actions: <static analysis, replay, limited verification, etc.>
Prohibited actions: <DoS, unauthorized assets, real user data, etc.>
Network mode: offline/lab_only/authorized_target_only
Expected delivery: Evidence, Finding, Reproduction, Repair Suggestions, ReportOrdinary users do not need to manually run complete tests when using only the warehouse. AI modification routing.json, scripts, Skill indexes or supply chain lists, they must automatically verify and repair failures in the following order, and then report the results to the user.
# 163 routes return
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/test-routing.ps1
# Structural consistency + supply chain pin gate
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/verify-routing-coherence.ps1
# Smoke and INDEX drift checks
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/smoke.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/extract-summaries.ps1 -Checkpwsh -NoProfile -File skills/scripts/test-routing.ps1
pwsh -NoProfile -File skills/scripts/verify-routing-coherence.ps1
pwsh -NoProfile -File skills/scripts/smoke.ps1
pwsh -NoProfile -File skills/scripts/extract-summaries.ps1 -Check| Check | Verify content | Look first when you fail |
|---|---|---|
| test-routing | 163 Hints map to expected PRIMARY | Failed use cases, priority, keywords must / exclude |
| verify-coherence | routes/priority, Skill path, supply chain pin, authorization reference | Number one BAD; don’t bypass the pin gate |
| smoke | Script analysis and Chinese and English fast routing examples | Missing files, PowerShell parsing errors |
| extract-summaries | Whether INDEX.md is synchronized with Skill summary | Regenerate first, then check the actual differences |
skills/config/routing.json, not in master-route.ps1 or master-route.sh Rewrite a hard-coded routing table. When adding new rules, regression use cases will also be added.Not required under normal circumstances.Users simply ask the AI to read it in full README_AI.md, and then provide authorization tasks. The commands on the page are used to demonstrate the process automatically executed by AI and facilitate auditing and troubleshooting; only permissions, credentials, commercial licenses, or external side effects must be confirmed by the user.
This project is oriented to authorization security research, including reverse engineering, Hook/debugging, scanning, unpacking, vulnerability verification, CTF method and tool bootstrapping, etc. Security products often use keywords, static features, and behavioral heuristics for detection; these research logics may share local features with malicious samples and therefore produce false positives.However, the detection results cannot be automatically treated as false positives.
The correct approach is: only obtain it from the official repository or Release; check the version, submission source and SHA-256; review the hit files and recent differences; run in an isolated virtual machine or sandbox with minimal permissions and a restricted network. Do not add the entire project directory directly to the whitelist. If you find binaries from unknown sources, unexpected networking, credential reading, persistent startup items, hash inconsistencies, or behavior beyond the scope, you should stop immediately and handle it as a real security incident.
AI can assist in calculating hashes, interpreting scripts, and reviewing differences, but it cannot bypass organizational policies for users. When reporting false positives, please provide the security software name, detection label, relative path, SHA-256, project version and download source; do not upload company code, real samples, credentials or other sensitive files.
Select when you just want stable use v1.0.1;Choose when you need the latest fixes and are willing to follow mainline changes main. Regardless of which version you choose, do not directly overwrite updates in a workspace that has unconfirmed local modifications.
Required, but automatically refreshed by AI. Updates may add tool definitions, candidate paths, or bootstrap hints; the AI should rerun the current platform's refresh script and report the results.
Immediately stop the target's actions. ask it to reread README_AI.md、RULES.md with skills/MASTER-ROUTING.md, run master-route and first report the PRIMARY, confidence, Scope plan and required tools.
This is a normal first run state. AI finished reading README_AI.md You must first run the refresh script of the current platform to generate two indexes, Markdown and JSON; users do not need to generate them manually.
Tell the AI tool that something just changed. The AI will re-refresh the index and check candidate paths; if still not found, it should report the detection process instead of asking the user to fake "installed".
AI only automatically runs bootstrap for the Required tools of the current PRIMARY Skill, and then refreshes the index after the installation is complete. Commercial tools follow manualInstallHint and license requirements, and the AI only asks the user when a license or administrator rights are required.
AI should recognize master-route.sh Requires Python 3, check if it can be safely installed automatically and verify python3 --version;Cannot be changed to another hard-coded Shell route.
AI can use process-level -ExecutionPolicy Bypass form, the policy should not permanently degrade the entire machine. When blocked by enterprise policy, the AI should explain the blocking and request an administrator to handle it.
The user can just add "target type + intention + key technology"; the AI will automatically rerun. Still blurry, AI turns on skills/routing.md Full Matrix selection and documentation of rationale in Case timeline.
AI reads every error entry: common reasons are auth.status is not granted, network mode is missing, non-offline Case has no assets, or ready_for_act Not true. AI correction can determine the field and confirm the real authorization to the user before re-running; it cannot be bypassed with Force.
The PowerShell entry is conservative by default to offline. AI confirms the sample ownership, local file path, prohibited external connections, and out_of_scope to the user, updates the Scope, and then automatically runs Case Guard; the user does not need to edit manually. Bash can be used by AI --preset offline-sample --sample ...。
AI processes in order: Scope error → Missing timeline/workitems/evidence → Finding without evidence reference → Inconsistent hash. It cannot modify the original evidence in order to pass review; it adds evidence and records supersedes relationships when corrections are needed.
Not recommended. AI should generate a unique CaseName for each new task; when it needs to be continued, append timeline, work item, and evidence to the original Case to avoid overwriting the previous structure.
You can write optional adaptations for a client, but you can't make the core depend on it. Do not change when migrating clients routing.json, Scope Contracts and Tests; only changes how the client loads project directives or skills.
It only facilitates developers to audit, reproduce and troubleshoot, and does not mean that ordinary users must perform it manually. SELECT appears when some browsers block the clipboard; this does not affect the AI automation process.