protocol-reverse

Reverse engineers custom binary protocols, Protobuf messages, and WebSocket frames from PCAP captures.

21|8|Updated Aug 3, 2026
One-click install
npx skills add https://github.com/chengzongcai/reverse-skill-backup --skill protocol-reverse-chengzongcai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: protocol-reverse
Source: https://github.com/chengzongcai/reverse-skill-backup/tree/main/skills/protocol-reverse
Command: npx skills add https://github.com/chengzongcai/reverse-skill-backup --skill protocol-reverse-chengzongcai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Analyzing undocumented network protocols is slow and error-prone when done ad hoc. This Skill provides a repeatable, authorization-aware workflow for reconstructing frame layouts, message dictionaries, and state machines from captured traffic and client binaries. ## Core Features & Use Cases - Frame Layout Recovery: Aligns multiple messages to identify magic bytes, length fields, sequence numbers, and CRC/HMAC checksums in custom TCP/UDP protocols. - Serialization Decoding: Recovers Protobuf, gRPC, FlatBuffers, and MessagePack schemas using tools like blackboxprotobuf and protoc --decode_raw. - PCAP-Driven Analysis: Extracts TCP payloads with tshark and drafts Wireshark dissectors, ImHex/010 templates, or Kaitai Struct definitions. - Use Case: Given a PCAP of a mobile game's private TCP protocol, produce a message type table (opcode, fields), a reproducible Python decode script, and a Connect-Auth-Ready state machine diagram. ## Quick Start Analyze the attached capture.pcap and reconstruct the custom binary protocol's frame layout and message dictionary.

Frequently Asked Questions about protocol-reverse

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reverse engineer a custom binary protocol from a PCAP file?▼

Extract TCP payloads with tshark, align multiple messages of the same type to find constant bytes, length fields, and sequence numbers, then identify checksums like CRC32 or HMAC. Document the frame layout and state machine, and write a reproducible Python decode script.

How to decode unknown Protobuf messages without the .proto file?▼

Use protoc --decode_raw to inspect field numbers and wire types, or blackboxprotobuf and pbtk to infer a schema from captured messages. Field numbers are encoded as varints, making blind decoding feasible without the original definition.

What tools are needed for network protocol reverse engineering?▼

tshark or Wireshark for PCAP parsing and Python for decode scripts are the core requirements. Optional tools include ImHex or 010 Editor for binary templates, Kaitai Struct for parser generation, and IDA or Ghidra for analyzing client-side serialization code.

When should I not use protocol reverse engineering workflow?▼

Skip it for pure HTTP parameter signing or JavaScript encryption, which belong to JS reverse engineering, and for TLS certificate issues handled by standard proxy tooling. Firmware protocol stacks may need firmware emulation first before returning to traffic analysis.

How do I handle encrypted protocol frames during analysis?▼

High-entropy frames with no plaintext indicate encryption; locate the nonce or IV near frame boundaries first. Then analyze the client binary or JS to find the key derivation logic before attempting decryption or replay within authorized scope.