Protocol Reverse
sickn33/agentic-awesome-skills
Authorized reverse engineering of custom binary protocols, Protobuf/gRPC schemas, WebSocket frames, and PCAP-driven protocol recovery.
A skill your agent uses for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery.
Install Protocol Reverse
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install zhaoxuya520/reverse-skill protocol-reverse --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/zhaoxuya520/reverse-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/protocol-reverse .claude/skills/protocol-reverse && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "protocol-reverse" agent skill from https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/protocol-reverse into .claude/skills/protocol-reverse/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "protocol-reverse", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/protocol-reverseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install zhaoxuya520/reverse-skill protocol-reverse --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zhaoxuya520/reverse-skill.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/protocol-reverse .agents/skills/protocol-reverse && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "protocol-reverse" agent skill from https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/protocol-reverse into .agents/skills/protocol-reverse/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "protocol-reverse", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install zhaoxuya520/reverse-skill protocol-reverse --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zhaoxuya520/reverse-skill.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/protocol-reverse .cursor/skills/protocol-reverse && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "protocol-reverse" agent skill from https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/protocol-reverse into .cursor/skills/protocol-reverse/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "protocol-reverse", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/zhaoxuya520/reverse-skill.git --path skills/protocol-reverse--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install zhaoxuya520/reverse-skill protocol-reverse --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zhaoxuya520/reverse-skill.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/protocol-reverse .gemini/skills/protocol-reverse && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "protocol-reverse" agent skill from https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/protocol-reverse into .gemini/skills/protocol-reverse/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "protocol-reverse", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install zhaoxuya520/reverse-skill protocol-reverseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/zhaoxuya520/reverse-skill.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/protocol-reverse .github/skills/protocol-reverse && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "protocol-reverse" agent skill from https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/protocol-reverse into .github/skills/protocol-reverse/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "protocol-reverse", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install zhaoxuya520/reverse-skill protocol-reverse --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zhaoxuya520/reverse-skill.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/protocol-reverse .opencode/skills/protocol-reverse && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "protocol-reverse" agent skill from https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/protocol-reverse into .opencode/skills/protocol-reverse/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "protocol-reverse", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
protocol-reverse- GitHub stars
- 40k
- Used in
- 2 other repos
- Token cost
- ~620 tokens
- SKILL.md length
- 152 words
- Files
- 2 (incl. references)
- Skills in repo
- 19
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery.
- Works in 4 steps: 采集与分诊 → 帧布局还原 → 序列化与加密 → …
- Authorized reverse engineering of custom binary protocols
- SKILL.md covers ACTION REQUIRED（读完后立刻执行）, 适用场景, 不走本 skill and 工作流, plus 4 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Protocol Reverse is an agent skill from zhaoxuya520/reverse-skill. Use for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery.
Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/protocol-workflow.md`).
It sits in Backend & APIs, covering gRPC and Protobuf, Reverse engineering and malware and Realtime and WebSockets. It works with gRPC and Wireshark. The repository describes itself as: Reverse Engineering / Authorized Penetration Testing / Security Research Skill Router Pack AI-powered routing + On-demand toolchain bootstrapping + Self-evolving knowledge base…. The licence is MIT.
When your agent uses it
- Authorized reverse engineering of custom binary protocols
- WebSocket frames
- PCAP-driven protocol recovery
Example prompts
- “/protocol-reverse”
Requirements
- Python 3
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit cab634b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Protocol Reverse loads about 620 tokens when it runs, and up to ~822 if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 152 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: warnings
The automated check found patterns that need a careful read before installing.
- WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:10
field-journal/precedent-reverse.md` — 确认授权与常规操作边界
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from zhaoxuya520/reverse-skill at commit cab634b, republished under its MIT licence (© zhaoxuya520). 152 words, ~620 tokens.
Download SKILL.mdSave it as
.claude/skills/protocol-reverse/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- protocol-reverse
- description
- Use for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery.
Protocol Reverse Engineering
ACTION REQUIRED（读完后立刻执行）
NOW: 读取../field-journal/precedent-reverse.md— 确认授权与常规操作边界NOW: 确认任务是否为协议/流量/序列化格式逆向（非纯 Web 参数签名 → 转js-reverse/）NOW: 若有目标网络交互 →../scripts/case-init.ps1完成 scope；auth未 granted 禁止对目标 ACTNEXT: 读取../tool-index.md；缺工具 bootstrap（tshark/wireshark 等可能需手动）ACT: 进入工作流 Phase 1，产出帧布局或消息字典草稿
适用场景
- 自定义 TCP/UDP 二进制协议
- Protobuf / gRPC / FlatBuffers / MessagePack
- WebSocket / MQTT / 私有 RPC
- PCAP / PCAPNG 还原字段与状态机
- 客户端-服务端校验、序列号、加密帧头
不走本 skill
| 情况 | 去哪 |
|---|---|
| 仅 HTTP 参数签名 / JS 加密 | js-reverse/ |
| 仅 TLS 证书问题 | pentest-tools/ 或浏览器代理 |
| 固件内协议栈深挖 + 仿真 | firmware-pentest/ 后再回本 skill |
工作流
Phase 1 — 采集与分诊
□ 拿到样本：PCAP / 代理导出 / 客户端日志 / 二进制
□ 标记方向：C→S / S→C；是否有握手、心跳、重连
□ 固定头？魔数？长度字段？TLV？定长？
□ 是否压缩（zlib/gzip/lz4）或加密（AES/ChaCha 帧内）
□ tshark -r cap.pcap -T fields -e frame.number -e ip.src -e tcp.payloadPhase 2 — 帧布局还原
□ 对齐多个同类消息，找不变字节 / 自增序列号
□ 长度字段：大端/小端、含头/不含头
□ 校验：CRC16/32、checksum、HMAC 位置
□ 画出状态机：Connect → Auth → Ready → Request/Response → Close
□ 工具：Wireshark 自定义 dissector 草稿 / ImHex / 010 Editor 模板 / Kaitai StructPhase 3 — 序列化与加密
□ Protobuf：.proto 恢复（blackboxprotobuf / pbtk / protoc --decode_raw）
□ gRPC：HTTP/2 headers + protobuf body
□ 加密：找密钥派生（客户端 so/dll/JS）→ 联合 ida-reverse / js-reverse / apk-reverse
□ 重放：仅在授权 scope 内；先无害字段再敏感操作Phase 4 — 产物
MUST 产出：
- 消息类型表（name / opcode / fields）
- 至少 1 条可复现的解码命令或脚本
- Evidence：原始 hex 摘录 + 解码结果（脱敏）工具链
| 工具 | 必需 | 用途 | 自举 |
|---|---|---|---|
| tshark / Wireshark | 强烈建议 | PCAP 解析 | 手动 / winget |
| Python3 | 是 | 解码脚本 | 系统 |
| blackboxprotobuf | 可选 | 未知 protobuf | pip |
| ImHex / 010 | 可选 | 结构模板 | 手动 |
| IDA / r2 / Ghidra | 按需 | 客户端序列化函数 | 见对应 skill |
参考
references/protocol-workflow.md— 帧布局与 Protobuf 速查- 相关：
../ida-reverse/../js-reverse/../firmware-pentest/../pentest-tools/
路由上下文
上游: MASTER-ROUTING R21 · routing.md
下游: 需客户端算法 → ida-reverse/js-reverse；需利用重放 → pentest-tools/api-security
同级: malware-analysis（C2 协议）、digital-forensics（流量取证）
任务完成自检
- 是否还原了消息布局或状态机（而非只贴 hex）？
- 是否有可复现解码命令？
- 是否遵守 scope / 脱敏？
- 是否回写 field-journal / 报告 Checklist？
© zhaoxuya520, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (references) in skills/protocol-reverse of zhaoxuya520/reverse-skill.
- SKILL.md
- references/protocol-workflow.md
Open the folder on GitHubat commit cab634b
Used in 2 other repositories
We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in zhaoxuya520/reverse-skill, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Protocol Reverse next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Protocol Reverse this skillzhaoxuya520/reverse-skill | 40k | 2 repos | ~620 | Automated safety check: Warn | MIT | |
| Protocol Reversesickn33/agentic-awesome-skills | 47k | 1 repos | ~689 | Automated safety check: Pass | MIT | |
| Web Reschlarpc/re-shell | 532 | — | ~1.4k | Automated safety check: Pass | None | |
| Use Yaakmountain-loop/yaak | 19k | — | ~1.9k | Automated safety check: Pass | MIT | |
| Spider Kingaoyunyang/spider-king-skill | 507 | — | ~7.3k | Automated safety check: Pass | MIT | |
| Dev Rulesrust-dd/tako | 162 | — | ~810 | Automated safety check: Pass | MIT |
Similar skills
Web Re
schlarpc/re-shell
Web reverse engineering tools and workflows. An agent skill from schlarpc/re-shell.
Use Yaak
mountain-loop/yaak
A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…
Spider King
aoyunyang/spider-king-skill
Pure-web protocol reverse skill: turn hostile browser clients into browser-free Python collectors.
Dev Rules
rust-dd/tako
General coding-style rules to apply to every project. An agent skill from rust-dd/tako.
Docs Writing
rust-dd/tako
Conventions for writing and maintaining tako documentation pages under website/content/docs/.
More from zhaoxuya520/reverse-skill
All 19 skills in this repoDiagram Generator
zhaoxuya520/reverse-skill
Turns text, notes, code, schemas or tables into diagram source in Mermaid, Graphviz DOT, PlantUML or SVG, and renders files when you ask for an image or PDF.
Supply Chain Security
zhaoxuya520/reverse-skill
A skill your agent uses for software supply-chain security assessment covering SBOM, SCA, CI/CD pipelines, container images, build integrity, dependency provenance, and vulnerability reachability.
Dsl Vm Reverse
zhaoxuya520/reverse-skill
Reverse JavaScript-based custom DSL/VM interpreters, non-standard WASM-like runtimes, and risk-control engines.
CTF ZIP Archive Key Recovery
zhaoxuya520/reverse-skill
Recovers internal keys from legacy ZipCrypto-protected ZIP archives in CTF challenges through a known-plaintext method, instead of brute force.
Browser Extension Reverse
zhaoxuya520/reverse-skill
A skill your agent uses for authorized reverse engineering of browser extensions (Chrome/Firefox) including manifest analysis, background workers, and extension-based credential or traffic logic…
Go Rust Reverse
zhaoxuya520/reverse-skill
A skill your agent uses for reverse engineering stripped Go and Rust binaries including runtime recognition, pclntab/moduel data recovery, panic strings, and idiomatic decompilation recovery.
Related
Categories
Questions about Protocol Reverse
What does Protocol Reverse do?
A skill your agent uses for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery. Protocol Reverse is an agent skill from zhaoxuya520/reverse-skill. Use for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery.
When should I use Protocol Reverse?
Protocol Reverse fits situations like: authorized reverse engineering of custom binary protocols; webSocket frames; PCAP-driven protocol recovery.
How do I install Protocol Reverse in Claude Code?
Run `npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a claude-code`. Or copy the skill folder (skills/protocol-reverse in zhaoxuya520/reverse-skill) into .claude/skills/protocol-reverse in your project. Claude Code loads it when a task matches its description.
How do I install Protocol Reverse in Codex?
Run `npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a codex`. Or copy the skill folder (skills/protocol-reverse in zhaoxuya520/reverse-skill) into .agents/skills/protocol-reverse in your project. Codex loads it when a task matches its description.
Can I use Protocol Reverse in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zhaoxuya520/reverse-skill --skill protocol-reverse -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/protocol-reverse, .gemini/skills/protocol-reverse, .github/skills/protocol-reverse and .opencode/skills/protocol-reverse in your project.
What does Protocol Reverse need to run?
SKILL.md names no scripts, command-line tools or credentials: Protocol Reverse is instructions for the agent only. Our summary lists: Python 3.
Does Protocol Reverse access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Protocol Reverse safe to install?
Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.
What licence does Protocol Reverse use?
Protocol Reverse is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Protocol Reverse use?
About 620 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 202 tokens, read only when the agent opens those files.
What are the alternatives to Protocol Reverse?
Skills that share tags, products or a category with Protocol Reverse: Protocol Reverse (sickn33/agentic-awesome-skills, 47k stars), Web Re (schlarpc/re-shell, 532 stars), Use Yaak (mountain-loop/yaak, 19k stars) and Spider King (aoyunyang/spider-king-skill, 507 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Protocol Reverse?
zhaoxuya520 (a GitHub user) maintains it in zhaoxuya520/reverse-skill, which has 40,112 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on September 22, 2026.
Source: zhaoxuya520/reverse-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.