protobuf
Skill4 starsChanged 11 days agoMITView on GitHub
Design and review Protobuf contracts: .proto schemas, Buf/codegen, evolution, Protovalidate/CEL, descriptors and runtime consumers. Use aip for Google resource API conventions.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- wordbricks/onequerytheir own version, first seen May 3, 2026
- broomva/lagotheir own version, first seen Apr 5, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- wordbricks/onequery★ 17same name
- broomva/lago★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository117 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- accessibilitySkill
- agent-watchdogSkill
- aipSkill
- animateSkill
- animation-performanceSkill
- animation-vocabularySkill
- ask-benSkill
- ask-sonnerSkill
- bazelSkill
- bend-lawsSkill
- blast-radiusSkill
- brain-dumpSkill
- break-uiSkill
- ci-fixesSkill
- codebase-designSkill
- codex-compatSkill
- codexSkill
- commit-push-prSkill
- connect-querySkill
- create-verification-skillSkill
- demoSkill
- development-lifecycleSkill
- diagnosing-bugsSkill
- docsSkill
- dogfoodSkill
- domain-modelingSkill
- e2e-testingSkill
- effect-tsSkill
- effect-v3-to-v4Skill
- efficient-frontierSkill
- eli5Skill
- excalidraw-diagramSkill
- extend-harnessSkill
- frontend-invariantsSkill
- frontend-starter-kitSkill
- full-sendSkill
- gesturesSkill
- golang-reviewSkill
- golangSkill
- goSkill
- grillingSkill
- handoffSkill
- hook-auditSkill
- implement-specSkill
- improve-animationsSkill
- improve-codebase-architectureSkill
- improveSkill
- launchdarklySkill
- lie-detectorSkill
- maintain-verification-skillSkill
- make-pr-easy-to-reviewSkill
- mobile-nativeSkill
- plan-arbiterSkill
- plow-aheadSkill
- postgresqlSkill
- primeSkill
- productSkill
- prototypeSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Treat the schema as a contract for serialization, generated code, validation and any descriptor-driven consumers, not just a transport DTO.
- Distinctive: line 24
Check binary, ProtoJSON, generated-source and behavioral compatibility separately.
- Distinctive: line 25
Read compatibility for schema or generation changes.
- Distinctive: line 26
Follow affected descriptors/messages through producers, adapters, storage and clients.
- Very specific: line 39
Use repository-owned commands and the pinned toolchain.
- Very specific: line 62
Use the parent review's findings schema.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Protobuf
Treat the schema as a contract for serialization, generated code, validation and any descriptor-driven consumers, not just a transport DTO. Apply only the layers the repository uses. Skill loading grants neither delegation nor migration permission.
Inspect the contract
- Pin the review base/head, including working changes when requested. Include deleted and renamed schemas, imports, custom options, generation config and affected output.
- Identify syntax/edition, compiler/plugins, runtime versions, Buf modules/locks, generation commands, compatibility policy, persisted messages and deployed consumers. Check binary, ProtoJSON, generated-source and behavioral compatibility separately.
- Read compatibility for schema or generation changes. Follow affected descriptors/messages through producers, adapters, storage and clients; generated code is evidence, never a hand-edit target.
- Load only relevant depth:
- Validation, requiredness or CEL changes: validation.
- TS/Python runtime or RPC consumers: runtimes.
- Reflection, custom options, forms or duplicated schema facts: schema-driven capabilities.
- APIs adopting Google resource conventions: load aip completely.
A
.protoextension alone does not make every General AIP applicable. - React Connect Query flows: load connect-query.
Verify behavior
Use repository-owned commands and the pinned toolchain. Where configured, exercise Buf format/build/lint, breaking detection against the actual review/deployed baseline, code generation and affected consumer checks. Honor module roots and existing rule categories; report weakened checks and policy gaps rather than silently changing policy.
A review stays read-only: generate into a disposable output/snapshot when necessary. Name unavailable tools, missing baselines and untested languages; passing lint or wire checks alone cannot prove semantic compatibility or runtime validation.
For a changed contract, seek a counterexample at its public seam: an old payload/new reader, new payload/old reader, unset versus explicit default, invalid request reaching the server, or an edit adapter losing information. During implementation, first make that counterexample fail a test; then fix and replay it through the real consumer.
Report two distinct results
- Defects: diff-introduced failures with an affected consumer/scenario, evidence, consequence, smallest compatible fix and verification. These affect the review verdict.
- Opportunities: optional schema-driven improvements grounded in actual duplication or an existing descriptor consumer. State the benefit, adoption cost and smallest experiment. Keep them out of inline defect comments and blocking findings. Missing Protovalidate, custom options, AIP conventions or a newer runtime is not itself a bug.
Use the parent review's findings schema; gate reviews put advisory capabilities in
simplification_opportunities, not findings or testing_gaps. Report verification
limits and rollout risks; do not invent independent review, cross-language parity or
conformance results.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

