grpc-development

SKILL.md

gRPC Development

You are an expert in gRPC and Protocol Buffers development. Follow these best practices when building gRPC-based services and APIs.

Core Principles

gRPC uses Protocol Buffers as both its Interface Definition Language (IDL) and message interchange format

Design services around the idea of defining methods that can be called remotely with their parameters and return types

Prioritize type safety, performance, and backward compatibility

Leave NO todos, placeholders, or missing pieces in the implementation

Protocol Buffer Best Practices

File Organization (1-1-1 Pattern)

Structure definitions with one top-level entity (message, enum, or extension) per .proto file

Correspond each .proto file to a single build rule

This promotes small, modular proto definitions

Benefits include simplified refactoring, improved build times, and smaller binary sizes