go-grpc

Standardize Go gRPC service development with Buf code generation and interceptor stacks.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/vincent119/ai-rules-kit --skill go-grpc-vincent119
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: go-grpc
Source: https://github.com/vincent119/ai-rules-kit/tree/main/skills/go-grpc
Command: npx skills add https://github.com/vincent119/ai-rules-kit --skill go-grpc-vincent119

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes and streamlines the development of Go gRPC services by providing a complete set of guidelines for Proto management, code generation with Buf, interceptor design, health checks, deadline handling, error code mapping, and graceful shutdown.

Core Features & Use Cases

  • Proto management and Buf configurations for reliable builds
  • Interceptor architecture including recovery, tracing, and logging
  • Health checking protocol and Kubernetes readiness/liveness integration
  • Deadline handling on both server and client sides with cancellation safety
  • End-to-end Go gRPC patterns for production-grade services
  • Use Cases: building robust Go microservices with consistent APIs and observability

Quick Start

Initialize a new Go gRPC service following this standard and bootstrap your server skeleton with the recommended Buf and interceptor setup.

Frequently Asked Questions about go-grpc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure interceptors in Go gRPC for logging and tracing?

Structure interceptors in Go gRPC by implementing a standard stack that includes recovery, tracing, and logging components. This architecture standardizes observability and error handling across server and client communications.

What's the best way to manage protobuf definitions and code generation for Go gRPC?

Manage protobuf definitions and code generation for Go gRPC by enforcing Buf for proto linting and generation. This standardizes builds and outputs generated code reliably into the api/gen/go directory.

How do I implement health checks in Go gRPC for Kubernetes readiness probes?

Implement health checks in Go gRPC by following the health checking protocol and integrating it with Kubernetes readiness and liveness probes. This ensures your microservices properly report their operational state.

How does deadline handling and cancellation work in Go gRPC services?

Deadline handling in Go gRPC services works by applying timeout configurations on both server and client sides with cancellation safety. This prevents hanging requests and ensures resources are released properly.

Can I use Buf for proto linting and generation in my Go microservices?

Yes, you can use Buf for proto linting and generation in Go microservices. It enforces reliable builds by standardizing proto management and outputting generated code directly into the api/gen/go directory.

How do I handle graceful shutdown in Go gRPC to avoid dropping requests?

Handle graceful shutdown in Go gRPC by applying standard patterns that stop accepting new requests while allowing in-flight operations to complete. This prevents dropping active connections during deployments.