OpenParable
Skip to content
← Back to skills

Protobuf Grpc Designer

Development
protobuf-grpc-designer

Protobuf Grpc Designer is an Agent Skill for development published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Protocol Buffers and gRPC service definition with backward compatibility checks

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/sdk-platform-development/skills/protobuf-grpc-designer/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/protobuf-grpc-designer, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Protocol Buffers and gRPC Designer Skill

Overview

This skill specializes in designing Protocol Buffers schemas and gRPC service definitions with a focus on backward compatibility, performance, and cross-language interoperability.

Capabilities

  • Design .proto files following Google's style guide and best practices
  • Implement gRPC service definitions with streaming support
  • Validate wire format backward compatibility
  • Generate language-specific stubs for multiple targets
  • Configure proto linting and breaking change detection
  • Design efficient message structures for performance
  • Implement gRPC interceptors and middleware patterns

Target Processes

  • API Design Specification
  • Backward Compatibility Management
  • Multi-Language SDK Strategy

Integration Points

  • buf (schema registry, linting, breaking change detection)
  • protoc (Protocol Buffer compiler)
  • grpcurl (gRPC testing)
  • gRPC-Gateway (REST transcoding)
  • Connect (modern gRPC alternative)

Input Requirements

  • Service domain requirements
  • Message structure definitions
  • Streaming requirements (unary, server, client, bidirectional)
  • Target languages for code generation
  • Backward compatibility policy

Output Artifacts

  • .proto schema files
  • buf.yaml configuration
  • Generated language stubs
  • Breaking change analysis report
  • API documentation from proto comments

Usage Example

skill:
  name: protobuf-grpc-designer
  context:
    protoDirectory: ./proto
    targetLanguages:
      - go
      - python
      - typescript
    enableBufLint: true
    checkBreakingChanges: true
    streamingRequired: true

Best Practices

  1. Use package names that reflect domain boundaries
  2. Reserve field numbers when removing fields
  3. Use well-known types (Timestamp, Duration, etc.)
  4. Document all messages and fields with comments
  5. Version services through package names
  6. Implement proper error handling with Status codes