skills.rest
doghelWang
doghelWangCOMMUNITY
Explore all skills by this author →
GitHub

Protobuf Semantic Mapper

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
One-click install
npx skills add https://github.com/doghelWang/amr_studio_v4 --skill protobuf-semantic-mapper
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
doghelWangdoghelWang

File Format Parser (JSON, XML, Protobuf)

Detect and parse JSON, XML, Protobuf, SQLite, and raw binary files.

Community
Intermediate
mf-dynatracemf-dynatrace

dt-obs-log-semantic-mapping

Suggest and validate audit log field mappings against the Dynatrace semantic dictionary.

Community
Advanced
juburrjuburr
1

go-protobuf

Generate Go protobuf code from proto3 schemas for gRPC services.

Community
Advanced
indrasvatindrasvat
3

api-compat

Detect breaking changes in protobuf, OpenAPI, GraphQL, and Go API definitions.

Community
Advanced