protocol-reverse SKILL.md skillA

protocol-reverse from novaestellar/novahaku is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add novaestellar/novahaku/protocol-reverse@git:20260910.546fe86

Pins git:20260910.546fe86 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
novaestellar/novahaku
Path
testing/protocol-reverse/SKILL.md
Versions recorded
1
Latest version
git:20260910.546fe86, committed Sep 10, 2026
Size
3,542 bytes
Repository stars
28
License
MIT

Use for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Protocol Reverse Engineering

## ACTION REQUIRED(读完后立刻执行)

1. `NOW`: 读取 `../field-journal/precedent-reverse.md` — 确认授权与常规操作边界
2. `NOW`: 确认任务是否为**协议/流量/序列化格式**逆向(非纯 Web 参数签名 → 转 `js-reverse/`)
4. `NEXT`: 读取 `../tool availability table`;缺工具 bootstrap(tshark/wireshark 等可能需手动)
5. `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 — 采集与分诊

```text
□ 拿到样本: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.payload
```

### Phase 2 — 帧布局还原

```text
□ 对齐多个同类消息,找不变字节 / 自增序列号
□ 长度字段:大端/小端、含头/不含头
□ 校验:CRC16/32、checksum、HMAC 位置
□ 画出状态机:Connect → Auth → Ready → Request/Response → Close
□ 工具:Wireshark 自定义 dissector 草稿 / ImHex / 010 Editor 模板 / Kaitai Struct
```

### Phase 3 — 序列化与加密

```text
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add novaestellar/novahaku/protocol-reverse@sha256:ce463404d4f55be6

The line at the top of this page pins the label git:20260910.546fe86, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3bxefmjpb5wcq2ak.svg)](https://markdownregistry.com/a/art_3bxefmjpb5wcq2ak)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 10, 2026.

versioncommittedcommitsizeaudit
git:20260910.546fe86 latest2026-09-10 546fe86 3,542 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3542 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

novaestellar/novahaku · 28 stars · license MIT · pushed 2026-09-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3bxefmjpb5wcq2ak
GET https://markdownregistry.com/api/v1/resolve?ref=novaestellar/novahaku/protocol-reverse
GET https://markdownregistry.com/api/v1/blob/ce463404d4f55be6069812c47d7b73cb2fc4e127c94728eb9a0dd062449a1db2

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from novaestellar/novahaku

novahaku SKILL.md skill
novaestellar/novahaku · SKILL.md · Novahaku — 统一安全研究代理。Web测试、提示工程、攻击框架、逆向工程、请求重构、OSINT侦察、CTF竞赛、源码猎人、MCP工具集成。所有能力,单一技能,自动检测。与novaxinwei(v1.1)协同…
v4.1.0 · audit A · 28 stars
docs-generator SKILL.md skill
novaestellar/novahaku · docs/docs-generator/SKILL.md · Creates task-oriented technical documentation with progressive disclosure. Use when writing READMEs, API docs…
git:20260910.546fe86 · audit A · 28 stars
CLAUDE.md@identity/novahaku-files/claude-config-bundle CLAUDE.md file
novaestellar/novahaku · identity/novahaku-files/claude-config-bundle/CLAUDE.md
git:20260830.727e3e8 · audit A · 28 stars
api-security SKILL.md skill
novaestellar/novahaku · testing/api-security/SKILL.md · Use for authorized security assessment of REST, GraphQL, WebSocket, or SOAP APIs, including discovery, authentication…
git:20260910.546fe86 · audit A · 28 stars
apk-reverse SKILL.md skill
novaestellar/novahaku · testing/apk-reverse/SKILL.md · 在 CLI 环境下做 Android APK 逆向时使用。适用于 APK 解包、Java 反编译、smali 修改、重打包、Frida 动态 Hook,以及按需切换到 so/native 分析。优先使用本机已安装的…
git:20260925.268b7c3 · audit B · 28 stars
binary-diff SKILL.md skill
novaestellar/novahaku · testing/binary-diff/SKILL.md · 跨版本符号迁移与二进制差分。当你有旧版本的符号/逆向结果,需要快速迁移到新版本时使用。 适用场景:内核缺 PDB 用旧版符号推导、程序更新后批量迁移函数名、应用更新后快速定位新偏移。 核心方法:用 LLM…
git:20260910.546fe86 · audit A · 28 stars
binary-ninja-reverse SKILL.md skill
novaestellar/novahaku · testing/binary-ninja-reverse/SKILL.md · Reverse engineering with Binary Ninja — HLIL/MLIL/LLIL intermediate languages, cross-references, type recovery, and…
git:20260925.7c760f5 · audit B · 28 stars
browser-automation SKILL.md skill
novaestellar/novahaku · testing/browser-automation/SKILL.md · 统一自动化入口。覆盖浏览器自动化(Playwright)和 Windows 桌面应用自动化(OpenReverse)。 浏览器场景:打开网页、点击、填表、爬取、截图、自动化登录、渗透页面交互。 桌面场景:操作 IDA/x64dbg 等…
git:20260910.546fe86 · audit A · 28 stars
browser-extension-reverse SKILL.md skill
novaestellar/novahaku · testing/browser-extension-reverse/SKILL.md · Use for authorized reverse engineering of browser extensions (Chrome/Firefox) including manifest analysis, background…
git:20260910.546fe86 · audit A · 28 stars
case-review SKILL.md skill
novaestellar/novahaku · testing/case-review/SKILL.md · Reviews a reverse-skill case package for scope readiness, Evidence to Finding to Path traceability, work item coverage…
git:20260924.07bab15 · audit A · 28 stars
cloud-k8s SKILL.md skill
novaestellar/novahaku · testing/cloud-k8s/SKILL.md · Use for authorized cloud, container, and Kubernetes security assessment including metadata SSRF, IAM misconfig…
git:20260928.e15e43c · audit A · 28 stars
cloud-saas-exposure SKILL.md skill
novaestellar/novahaku · testing/cloud-saas-exposure/SKILL.md · Organization-grade cloud and supply-chain attack-surface discovery: S3/GCS/Azure Blob bucket discovery via…
v1 · audit A · 28 stars

Every file in novaestellar/novahaku

Browse by kind, by grade A, or by owner.