Protobuf Semantic Mapper

Name: Protobuf Semantic Mapper
Availability: InStock
Author: doghelwang

Derive hierarchical Protobuf tag-to-string-key mappings from protoc output and reference JSON.

Updated Mar 8, 2026

Search Tags:#json #protobuf #mapping #reverse-engineering #semantic-mapping #decode_raw

Ready to run

npx skills add https://github.com/doghelWang/amr_studio_v4 --skill protobuf-semantic-mapper

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Protobuf Semantic Mapper
Source: https://github.com/doghelWang/amr_studio_v4/tree/main/skills/protobuf_semantic_mapper
Command: npx skills add https://github.com/doghelWang/amr_studio_v4 --skill protobuf-semantic-mapper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Protobuf Semantic Mapper automates the discovery of semantic structure from opaque Protobuf schemas by aligning a raw protoc decode with a reference JSON, producing meaningful tag-to-key mappings.

Core Features & Use Cases

Heuristic cross-referencing between leaf values in a reference JSON and a decoded Protobuf tree to derive hierarchical mappings.
Generates a context-aware mapping dictionary that can be plugged into deserializers to reconstruct semantic structures.
Useful for debugging, schema evolution, and interoperability when Protobuf schemas are undocumented or missing.

Quick Start

Run the derive_semantic_mapping.py script with your origin JSON and raw protoc text to generate the mapping.

Frequently Asked Questions about Protobuf Semantic Mapper

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

FAQPage Schema

How do I map raw protoc decode_raw output to meaningful JSON keys?▼

To map raw protoc decode_raw output to JSON keys, you cross-reference leaf values from a reference JSON with the decoded Protobuf tree to derive hierarchical tag-to-string mappings. This heuristic alignment automates semantic structure discovery.

What is semantic mapping for undocumented Protobuf schemas?▼

Semantic mapping for undocumented Protobuf schemas is the process of deriving tag-to-string-key mappings by aligning a raw decoded Protobuf tree with a known reference JSON. It reconstructs missing schema semantics for debugging and interoperability.

How do I reverse engineer a Protobuf schema from a reference JSON?▼

To reverse engineer a Protobuf schema from a reference JSON, run the derive_semantic_mapping script with your reference JSON and raw protoc text. It outputs a context-aware mapping dictionary for deserializers.

Can I derive Protobuf semantics for cross-service interoperability without the original schema?▼

Yes, you can derive Protobuf semantics for cross-service interoperability without the original schema. The Skill heuristically matches decoded Protobuf leaf values against a reference JSON to generate a usable mapping dictionary.

What are the limitations of heuristic semantic mapping for Protobuf?▼

The limitations of heuristic semantic mapping for Protobuf include relying on the availability of an accurate reference JSON. It requires a raw protoc decode_raw output and cannot infer semantics for structures missing from the reference data.