grpc-service-guidelines

Enforce Google AIP-based gRPC service patterns in Go.

1|Updated Mar 21, 2026

Search Tags:#validation #go #observability #grpc #aip #lro

Ready to run

npx skills add https://github.com/dashkan/pivox-server --skill grpc-service-guidelines

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: grpc-service-guidelines
Source: https://github.com/dashkan/pivox-server/tree/main/.agents/skills/grpc-service-guidelines
Command: npx skills add https://github.com/dashkan/pivox-server --skill grpc-service-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Production-grade gRPC service development in Go following Google AIP standards. This guide helps teams build robust, maintainable services by codifying best practices for architecture, validation, error handling, observability, and testing.

Core Features & Use Cases

Establish a consistent Go gRPC code structure with clean architecture and error handling patterns.
Standardize validation, authentication, LROs, OpenAPI generation, and observability across services.
Use as a reference during scaffolding, code reviews, and onboarding for new gRPC backends.

Quick Start

Follow these guidelines when starting a new gRPC service in Go to ensure alignment with AIP standards.

Frequently Asked Questions about grpc-service-guidelines

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

FAQPage Schema

How do I structure a production-grade gRPC service in Go?▼

Structuring a production-grade gRPC service in Go requires enforcing clean architecture patterns across scaffolding, proto definitions, and PostgreSQL-backed backends. These guidelines standardize authentication, validation, and error handling to ensure maintainability.

What is the best way to handle gRPC errors in Go following Google AIP?▼

Handling gRPC errors in Go following Google AIP involves utilizing an internal apierr package for consistent error mapping. This approach ensures standardized error handling across your production services and aligns with Google API improvement proposals.

How do I implement validation for gRPC requests in Go?▼

Implementing validation for gRPC requests in Go is achieved by integrating protovalidate into your service workflow. This enforces standardized input validation directly within your proto definitions, conforming to Google AIP guidelines.

Can I use these gRPC guidelines for long-running operations in Go?▼

You can use these gRPC guidelines for long-running operations, or LROs, in Go. The patterns provided standardize LRO implementation alongside observability and OpenAPI generation for PostgreSQL-backed backends.

Does this gRPC Go guideline support OpenAPI generation?▼

These gRPC Go guidelines support OpenAPI generation to provide consistent API documentation. By conforming to Google AIP standards, the workflow ensures your proto definitions generate accurate OpenAPI specs for your services.