proto

Document Forge proto file conventions and annotation rules for code generation.

4|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/reliant-labs/forge --skill proto-reliant-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proto
Source: https://github.com/reliant-labs/forge/tree/main/internal/templates/project/skills/forge/proto
Command: npx skills add https://github.com/reliant-labs/forge --skill proto-reliant-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proto files in Forge projects can silently drift from the conventions that drive reliable code generation, causing failing builds, out-of-sync ORM state, and confusing generator errors.

Core Features & Use Cases

  • Proto-first structure guidance: Clarifies where service, entity, and shared proto files belong, enforcing the one-service-per-file approach.
  • Annotation and field rules: Defines how to mark entities, primary keys, tenant scoping, timestamps, and field behaviors so Forge can generate correct CRUD and ORM layers.
  • Conventions for safe evolution: Covers enum requirements, reserved fields, List request optional filters, and correct handling of greenfield vs migrated projects.
  • Error prevention workflows: Explains the canonical workflow (forge generate + forge lint + forge build) and why running buf generate alone leads to ORM out-of-sync checks.

Quick Start

Ask the skill to review your proto file named service task definitions and tell you what to change so it satisfies Forge entity, field, and CRUD conventions before you run forge lint --conventions.

Frequently Asked Questions about proto

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

FAQPage Schema
How do I define proto file conventions for CRUD and ORM code generation?

Proto file conventions for CRUD and ORM code generation require correct forge/v1/forge.proto imports, one service per file, and explicit pk and tenant/timestamps annotations on entity messages to ensure proper layer generation.

Why does running buf generate alone cause ORM out-of-sync checks in Forge projects?

Running buf generate alone causes ORM out-of-sync checks because it bypasses Forge's canonical workflow. You must run the forge generate, forge lint, and forge build sequence to ensure generated artifacts and ORM state remain aligned.

How do I annotate multi-tenancy and timestamps in Forge proto entity messages?

To annotate multi-tenancy and timestamps in Forge proto entity messages, apply explicit tenant and timestamp annotations directly within your entity definitions, ensuring the generator correctly scopes data and tracks creation or modification times.

What are the proto field and enum rules for safe evolution in Forge projects?

Proto field and enum rules for safe evolution in Forge projects require using stable field numbers, reserving deleted fields, following enum requirements, and including optional filter fields in List requests to handle greenfield and migrated projects safely.

How do I structure List RPC requests and responses for Forge proto files?

To structure List RPC requests and responses in Forge proto files, follow Forge CRUD conventions by including optional filter fields in the request and defining the correct request and response structures to pass lint checks.