move-away-from-grpc-gateway

Official

Migrate mockgcp from grpc-gateway to httptogrpc

AuthorGoogleCloudPlatform
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps you replace locally generated grpc-gateway proto bindings in mockgcp with reflection-based routing using the official Google Cloud Go client protos, reducing mismatch risk and aligning mock behavior with real clients.

Core Features & Use Cases

  • Stops grpc-gateway proto generation: Removes the target service from the grpc-gateway generation Makefile steps.
  • Cleans generated artifacts: Deletes the generated .pb.go, .pb.gw.go, and _grpc.pb.go outputs for all versions of the service.
  • Switches HTTP handling to httptogrpc: Replaces httpmux usage with httptogrpc.NewGRPCMux(conn) and updates header/error handling expectations.
  • Updates proto imports and types: Migrates Go code to cloud.google.com/go/<service>/apiv1/<service>pb and resolves any strict type differences during compilation.

Quick Start

Use the move-away-from-grpc-gateway skill to migrate a specific mockgcp service to httptogrpc by editing the Makefile, deleting generated grpc-gateway files, updating imports, and changing the NewHTTPMux implementation to register official gRPC clients with NewGRPCMux.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: move-away-from-grpc-gateway
Download link: https://github.com/GoogleCloudPlatform/k8s-config-connector/archive/main.zip#move-away-from-grpc-gateway

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.