--- title: "Protobuf gRPC API Review: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/skills/github-protobuf-grpc-api-review/ description: "Reviews .proto and gRPC changes as long-lived contracts across binary wire, JSON and text formats, generated APIs and runtime behavior, with mixed-version rollout tracing and a four-rung verdict." --- # Protobuf gRPC API Review: review, setup & limitations · Undominated.ai > Reviews .proto and gRPC changes as long-lived contracts across binary wire, JSON and text formats, generated APIs and runtime behavior, with mixed-version rollout tracing and a four-rung verdict. [← Explore all skills](/skills/) API DESIGN / GitHub community # Protobuf gRPC API Review Reviews .proto and gRPC changes as long-lived contracts across binary wire, JSON and text formats, generated APIs and runtime behavior, with mixed-version rollout tracing and a four-rung verdict. [See setup guidance ↓](#setup)[Original source ↗](https://github.com/github/awesome-copilot/tree/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review) SOURCE REVIEW Reviewed 2026-10-15 Evidence 7 linked sources Publisher GitHub community Licence [MIT ↗](https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/LICENSE) Revision 3a685010a7af [Read what was—and wasn’t—checked ↓](#review) “Review Protocol Buffer (.proto) and gRPC API changes for wire and JSON compatibility, safe schema evolution, rollout hazards, and RPC contract quality. Use when reviewing proto diffs, adding or changing messages and services, planning migrations, or diagnosing cross-version failures.” [GitHub community · upstream description ↗](https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review/SKILL.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - Compatibility is evaluated on four independent dimensions (binary wire, named formats, generated source API, behavior and operations) instead of a single wire-compatibility verdict. - Every non-trivial change is traced through mixed-version paths including rollback after new writers have emitted, with a verdict ladder that admits insufficient context. ### A good fit for - Reviewing .proto diffs for breaking field, enum or service changes - Planning additive-evolution migrations with reader-first rollout sequencing - Trace unknown-field preservation through an old-client read-modify-write path. ### Weigh up before choosing - Verdicts are only as good as the declared compatibility envelope; the skill itself requires lowering confidence when encodings, consumers or deployment order are unknown. - It directs the use of the repo's own protoc, Buf or breaking-change checks but runs none itself; an unverified checklist item stays a risk, not a pass. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - skills/protobuf-grpc-api-review/SKILL.md - skills/protobuf-grpc-api-review/references/protobuf-compatibility.md - LICENSE - vercel-labs/skills@7407f3893ad4dceab546ac002c3ef806e4000c73:README.md ### Our findings - Default safety principles forbid field and enum number reuse, treat oneof moves and cardinality changes as breaking, and require idempotency before recommending retries. - The false-positive guardrails refuse to demand streaming, retries or transcoding everywhere and refuse to flag additive optional fields as breaking. - Findings carry a fixed evidence shape (severity, location, dimension, old-to-new change, failing scenario, remediation) plus a compatibility matrix and proving tests. - The compatibility scenarios include an old reader modifying and reserializing a new message, and rollback after new writers emit values; retry recommendations require idempotency or deduplication for state-changing RPCs. ### Not established by this review - No .proto change was reviewed with this skill. - Descriptor compilation and breaking-change checks were not executed. - Not executed: it was not installed or run. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Add a skill to your workflow. [Upstream setup instructions ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md) DOCUMENTED COMMAND npx skills add github/awesome-copilot/skills/protobuf-grpc-api-review --skill protobuf-grpc-api-review Copy command ↗ Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above. Optional: install the reviewed revision Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose. npx skills add https://github.com/github/awesome-copilot/tree/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review --skill protobuf-grpc-api-review Copy reviewed-revision command ↗ - Install the complete skill directory with its references; select your AI tools and project or global scope. - Review the instructions before invoking them. The source revision shown here is the one reviewed; the installer was not executed or version-pinned by this review. ### Before you start - Node.js/npm and git for the documented Skills installer - An agent host that supports the skill format - Access to old and new schema definitions plus deployment and consumer context ### Compatibility Agent Skills-compatible coding agents · Protobuf and gRPC codebases with their compiler or lint tooling where available ### Schema and repository reads; optional tool runs - Read .proto files, generated code and call sites - Run the repo's descriptor compilers and breaking-change checks where available - Review output only; schema edits stay a human decision ### Cost model The skill is MIT-licensed; agent calls and build tooling remain separate. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [Skill definition at reviewed revision ↗](https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review/SKILL.md) Checked 2026-10-07 https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review/SKILL.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access - [Reviewed reference or helper: references/protobuf-compatibility.md ↗](https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review/references/protobuf-compatibility.md) Checked 2026-10-07 https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review/references/protobuf-compatibility.md Supports: review, whySelected - [Upstream license or licensing declaration ↗](https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/LICENSE) Checked 2026-10-07 https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/LICENSE Supports: license - [Publisher installation and project documentation ↗](https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/README.md) Checked 2026-10-07 https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/README.md Supports: install, compatibility, access - [Skills installer source formats and selective installation ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md) Checked 2026-10-07 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md Supports: install - [Installer implementation: full commit SHA fallback ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts) Checked 2026-10-07 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts Supports: install - [Pinned continuation review W28 ↗](https://raw.githubusercontent.com/github/awesome-copilot/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/github/awesome-copilot/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/protobuf-grpc-api-review/SKILL.md Supports: review.findings, bestFor KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Error Model Validation Architect ↗ Turns ad-hoc exception handling into a deliberate public error contract: an explicit taxonomy across eight failure categories, status-code mapping rules, machine-readable codes separated from human messages, framework exception coverage, and a logging rule that keeps internal detail out of client payloads.](/skills/jetbrains-error-model-validation-architect/)[### Integration Resilience Engineer ↗ Designs resilient HTTP, messaging and scheduled integrations: timeout budgets derived from the caller’s SLO, retryable-versus-terminal failure classification, idempotency and deduplication, circuit breakers, DLQ behaviour, and distributed locking for scheduled jobs.](/skills/jetbrains-integration-resilience-engineer/)[### Buf Protocol Buffers Design and Toolchain ↗ Official Buf skill for Protocol Buffers (.proto) design, buf.yaml toolchain configuration, Connect/gRPC service authoring, and breaking change prevention.](/skills/buf-protobuf/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Choose a toolkit](/tools/) - [Inspect execution hosts](/agents/) - [Check tool access](/mcp-servers/) - [Check project dependencies](/check-repo/)