CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/protobuf-compat-checking

Use when a pull request changes .proto files for gRPC services, Buf Schema Registry modules or message-bus payloads, and consumers must not break. Runs buf breaking against a past version, picks the FILE, PACKAGE, WIRE_JSON or WIRE category, sets exemptions and gates CI.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-organized reference: every section gives executable commands or config, and the baseline-selection and CI sections cover the realistic scenarios. Minor improvements possible in trimming a few redundant sentences and adding an explicit findings-triage loop.

Suggestions

Trim restatement sentences like 'This is the most common CI pattern: compare PR against main' and the hermetic-builds aside to tighten token efficiency.

Add a short triage step after 'Reading the report' describing the fix-vs-exempt decision loop (fix the schema vs add ignore_only/except, then re-run buf breaking).

Move the full GitHub Actions workflow and JSON output schema into a references/ file, keeping SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The category table, buf.yaml block, and command examples are efficient and earn their tokens, but a few sentences restate the obvious ("This is the most common CI pattern: compare PR against main", "Useful for hermetic builds where the baseline is published as an artifact"). Fits 'efficient with minor instances that could be trimmed' better than the lean-every-token-counts anchor.

4 / 5

Actionability

Fully executable throughout: copy-paste ready `buf breaking` invocations for git/BSR/tarball baselines, a complete buf.yaml v2 config, `--error-format json` with a jq triage one-liner, a full GitHub Actions workflow, and a tag-based release script covering the common cases.

5 / 5

Workflow Clarity

Sections sequence logically (category choice → configuration → baseline selection → report reading → CI gate) and the non-zero exit / CI gating provides a validation checkpoint, but there is no explicit triage loop for acting on findings (e.g. when to fix the field vs apply ignore_only), leaving a minor validation gap versus the 5 anchor.

4 / 5

Progressive Disclosure

No bundle files exist, so everything is inline in a single ~220-line file; it is well-sectioned with clear headers and clearly signaled external doc links. Good structure with minor gaps — the CI YAML and JSON output details could live in separate reference files — which fits the 4 anchor better than the well-split 5 anchor.

4 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit 'Use when' trigger clause, third-person voice, and multiple concrete capabilities. Its only weakness is missing a few natural synonyms (e.g. 'protobuf', 'backward compatibility') that users might say.

Suggestions

Add natural synonyms such as 'protobuf', 'backward/prototype compatibility', or 'schema compatibility' to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Runs buf breaking against a past version", "picks the FILE, PACKAGE, WIRE_JSON or WIRE category", "sets exemptions and gates CI" — with comprehensive coverage of the skill's scope and no real gaps, matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Explicitly answers both questions: an explicit "Use when a pull request changes .proto files..." trigger clause and a clear third-person "what" enumerating four concrete actions. The 'when' is explicit and concrete, so it exceeds the 4 anchor where 'when' could be more specific.

5 / 5

Trigger Term Quality

Strong natural terms ("pull request", ".proto files", "gRPC services", "Buf Schema Registry", "message-bus payloads") but common synonyms a user would say — "protobuf", "backward compatibility", "schema compatibility" — are absent, placing it at good-coverage-with-a-few-missing rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Protobuf breaking-change gating on .proto/BSR/message-bus changes) with distinct, unambiguous triggers and minimal overlap risk; nothing generic that would fire for unrelated skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

On this page