# Buf Protobuf Linter

> Lints Protocol Buffer definitions using the Buf CLI ruleset and validates gRPC service contracts, detecting breaking changes between proto revisions with git integration.

- Skill: `agentskillexchange/buf-protobuf-linter` (Agent Skill)
- Install (CLI): `npx skillmds add agentskillexchange/buf-protobuf-linter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/buf-protobuf-linter/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs, DevOps & Infra, REST & GraphQL APIs
- Tags: Breaking Changes, Buf, Grpc, Linting, Protobuf
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/agentskillexchange/buf-protobuf-linter

---


# Buf Protobuf Linter

Lints Protocol Buffer definitions using the Buf CLI ruleset and validates gRPC service contracts. Detects breaking changes between proto revisions using buf breaking with git integration.

## Installation

Use the upstream install or setup path that matches your environment:
- brew install bufbuild/buf/buf

Requirements and caveats from upstream:
- [![Docker](https://img.shields.io/docker/pulls/bufbuild/buf)](https://hub.docker.com/r/bufbuild/buf)
- Other supported installation methods include [npm], [Windows], [Docker], [binary downloads], [tarballs], [source builds], and [minisign verification][verifying]. See the [installation docs][install] for the full list.
- [docker]: https://buf.build/docs/cli/installation/#docker

Basic usage or getting-started notes:
- sh
- Initialize a workspace and run the checks you should expect every Protobuf repository to pass:
- buf config init

- Source: https://github.com/bufbuild/buf
- Extracted from upstream docs: https://raw.githubusercontent.com/bufbuild/buf/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/buf-protobuf-linter/)