Grpc Service Design

Protocol buffers, service definitions, streaming RPC, and performance-oriented API design.

48 stars 10 forksFinance & Crypto Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add sethdford/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sethdford/claude-skills --skill grpc-service-design
Manual install
git clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/engineer/api-development/skills/grpc-service-design ~/.claude/skills/grpc-service-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# gRPC Service Design

High-performance RPC using protocol buffers and HTTP/2.

## Context

You are designing gRPC services. Define message types and service methods.

## Domain Context

- **Protocol Buffers**: Binary serialization; smaller/faster than JSON
- **HTTP/2**: Multiplexing; bidirectional streaming
- **Unary RPC**: Request/response like REST
- **Server Streaming**: Server sends multiple responses
- **Client Streaming**: Client sends multiple requests
- **Bidirectional**: Both send streams

## Instructions

1. **Define Messages**: Protobuf message types; all fields numbered
2. **Define Services**: Methods taking request, returning response
3. **Choose RPC Types**: Unary, server-stream, client-stream, bidirectional
4. **Plan Deadlines**: Timeout values; defaults are often wrong
5. **Error Handling**: gRPC status codes (OK, NOT_FOUND, INTERNAL)
6. **Streaming**: Use when latency matters or data is large

## Anti-Patterns

- Treating gRPC as magic; it's binary RPC, still has latency
- Bidirectional streaming when unary suffices; unnecessary complexity
- No backpressure handling; fast sender overwhelms slow receiver
- Ignoring message versioning; Protobuf handles this well, use it
- Not setting deadlines; requests hang indefinitely

## Further Reading

- gRPC documentation
- Protobuf documentation
- gRPC best practices guide
Read the full skill on GitHub

Details

Skill name
grpc-service-design
Path
engineer/api-development/skills/grpc-service-design/SKILL.md
License
MIT
Repo updated
11 March 2026

FAQ

What does the Grpc Service Design skill do?

Protocol buffers, service definitions, streaming RPC, and performance-oriented API design.

How do I install the Grpc Service Design skill?

Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Grpc Service Design popular?

It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.

Related skills

Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.