go-grpc-contracts

Change or review Go gRPC or Protocol Buffers services, RPC status mapping, streaming, generated stubs, compatibility, deadlines, or protobuf field evolution. Use for .proto files and grpc.Server or grpc.ClientConn code.

szybnev/dev-skills7 installsApache-2.0Synced Aug 26

Works with

Claude CodeCursorCodex CLIGitHub CopilotGemini CLI
---
name: go-grpc-contracts
description: Change or review Go gRPC or Protocol Buffers services, RPC status mapping, streaming, generated stubs, compatibility, deadlines, or protobuf field evolution. Use for .proto files and grpc.Server or grpc.ClientConn code.
license: Apache-2.0
---

# Go gRPC contracts

Read [rules.md](references/rules.md). Inspect the `.proto` and generated-code command before editing. Treat field numbers and RPC semantics as public API.

1. Preserve existing field numbers and names; add new optional fields instead of reusing.
2. Pass and honor RPC context, including stream cancellation.
3. Map domain failures to explicit gRPC status codes at the server boundary.
4. Do not hand-edit generated stubs.
5. Regenerate with the repository command and test a client-visible contract.

Do not add retries until idempotency and deadline behavior are specified.

More API Design skills

← All API Design skills

Check your AI visibility

One URL in, a 0–100 score and the exact fixes out.

RUN THE CHECK

Browse all the tools

15 tools across six categories
13 of them never send your data anywhere

Free · No signup · No trial clock

SEE THE DIRECTORY