golang-grpc

The golang-grpc skill provides comprehensive guidance for implementing, reviewing, and debugging gRPC services in Golang. It addresses common challenges in distributed systems by offering best practices for defining services, structuring protobuf files, generating code, and ensuring production-grade reliability. By separating transport logic from business logic and standardizing patterns such as interceptors, error handling, and TLS/mTLS configuration, this skill helps developers maintain clean, robust, and maintainable gRPC microservices.

Key features include advice on proto file organization using domain and versioned directories, recommended code generation tools like protoc and buf, patterns for implementing health checks and interceptors, and strategies for client connection reuse and call deadlines. It also covers error handling with gRPC status codes, rich error details, streaming RPCs, and testing using bufconn. Additional guidance includes disabling reflection in production, graceful server shutdown, and leveraging middleware ecosystems to handle cross-cutting concerns effectively.

This skill is particularly useful for Go distributed systems engineers, backend developers, and DevOps teams working on microservices architectures. Typical use cases include building new gRPC servers or clients from scratch, auditing and reviewing existing gRPC code for correctness, implementing robust error handling and observability, configuring secure transport with TLS/mTLS, and setting up testing frameworks. It is designed for projects that use Golang and integrates smoothly with AI coding assistants like Claude Code for guidance and best practice recommendations.