Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Go gRPC Best Practices · samber | DecimalAI

codingby samber

Go gRPC Best Practices

samber/golang-grpc

Source samber/cc-skills-golang ↗License MIT

Provides gRPC usage guidelines, protobuf organization, and production-ready patterns for Golang microservices.

SkillScore86Maintained

Automatic

Coding pack

Last verified 9/9/2026

What it changes

Passed 19 of 22 test cases with the skill, and 15 of 22 without it.

Without skill68%

With skill86%

Checks it passed that the model alone missed

The context is wrapped using metadata.NewOutgoingContext.
Server reflection registration is omitted in production mode.
The RPC response parameter uses a dedicated response message type.

and 1 more in the full report

4 fixed15 passed either way3 still failing0 broke

Pass-rate lift: +18 pp
Tokens: +156%
Agent turns: 0%
Response time: +1%

Model gemini-3.6-flashMeasured 9/9/2026v219 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/samber-golang-grpc/SKILL.md https://app.decimal.ai/s/samber-golang-grpc/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add samber-golang-grpc, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/samber-golang-grpc/ and pins it in .decimal/skills.lock

decimalai skills add samber-golang-grpc

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/samber-golang-grpc/SKILL.md https://app.decimal.ai/s/samber-golang-grpc/SKILL.md

Raw file: /s/samber-golang-grpc/SKILL.md ↗ · machine-readable summary at /s/samber-golang-grpc.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 4 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 4

Prompt

An authenticated Go gRPC user with role 'viewer' attempts to invoke a method requiring 'admin' privileges. A developer returned `status.Error(codes.Unauthenticated, "unauthorized")`. Write the corrected Go error return statement.

What was checked, without and with the skill
Checked	Without skill	With skill
The return statement uses status.Errorf with code codes.PermissionDenied.	Missed	Passed

case-08 · gemini-3.6-flash · 9/9/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md202 lines3 files

Persona: You are a Go distributed systems engineer. You design gRPC services for correctness and operability — proper status codes, deadlines, interceptors, and graceful shutdown matter as much as the happy path.

Modes:

Build mode — implementing a new gRPC server or client from scratch.
Review mode — auditing existing gRPC code for correctness, security, and operability issues.

Dependencies:

protoc: brew install protobuf
protoc-gen-go: go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
protoc-gen-go-grpc: go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

Go gRPC Best Practices

Treat gRPC as a pure transport layer — keep it separate from business logic. The official Go implementation is google.golang.org/grpc.

This skill is not exhaustive — refer to library documentation and code examples for more information:

For Go package docs, symbols, versions, importers, and known vulnerabilities, → See samber/cc-skills-golang@golang-pkg-go-dev skill (godig), preferred over Context7 for Go package facts.
To navigate this library's usage in your own code (definitions, call sites, diagnostics), → See samber/cc-skills-golang@golang-gopls skill (gopls).
Context7 remains a fallback for docs not indexed on pkg.go.dev.

Quick Reference

Concern	Package / Tool
Service definition	`protoc` or `buf` with `.proto` files
Code generation	`protoc-gen-go`, `protoc-gen-go-grpc`
Error handling	`google.golang.org/grpc/status` with `codes`
Rich error details	`google.golang.org/genproto/googleapis/rpc/errdetails`
Interceptors	`grpc.ChainUnaryInterceptor`, `grpc.ChainStreamInterceptor`
Middleware ecosystem	`github.com/grpc-ecosystem/go-grpc-middleware`
Testing	`google.golang.org/grpc/test/bufconn`
TLS / mTLS	`google.golang.org/grpc/credentials`
Health checks	`google.golang.org/grpc/health`

Proto File Organization

Organize by domain with versioned directories (proto/user/v1/). Always use Request/Response wrapper messages — bare types like string cannot have fields added later. Generate with buf generate or protoc.

Track record

Benchmark

19 / 22

test cases passed, vs 15 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 9/8/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

samber / cc-skills-golang

skills/golang-grpc/SKILL.md

View on GitHub ↗

License MITImported 9/8/2026Version v2Bundled 2 files

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

grpc-golangBuild production-ready gRPC services in Go with mTLS, streaming, and observability. Use when designing Protobuf contracts with Buf or implementing secure service-to-service transport.Close match-100 pp pass-rate lift

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Go gRPC Best Practices

Quick Reference

Proto File Organization

Track record

Benchmark

Adoption

SkillSafety

Source

Other skills for the same job

Related skills