Skills
.Work. You
Rest

buf-version-pinning

Official

Stabilize generated code by pinning Buf plugins

Software Engineering#plugin#code-generation#version-pin#buf#buf.yaml#buf.lock#regen
Authorblock
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Pinning Buf plugin versions keeps generated code stable by preventing unintended diffs when buf.gen.yaml, buf.yaml, or buf.lock change.

Core Features & Use Cases

  • Pin and align plugin versions across buf.yaml, buf.lock, and buf.gen.yaml to prevent drift.
  • Predict and surface regen impact before merging.
  • Validate that buf.lock and dependencies align after plugin changes.
  • Guidance to run just gen and group diffs for downstream consumers (Connect-RPC, sqlc, SDK shapes).

Quick Start

Update the plugin version in buf.gen.yaml and run just gen to review the regen impact before committing.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 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: buf-version-pinning
Download link: https://github.com/block/proto-fleet/archive/main.zip#buf-version-pinning

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.