CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

proto-bump

Change the org.meshtastic:protobufs pin for Meshtastic-Android — to a tagged release or to a commit snapshot (X.Y.Z.N-g<sha>-SNAPSHOT) from protobufs master. Verifies with test/allTests (not compile alone) via the gradle-runner subagent, audits the new field surface, and opens a PR. Use to consume new proto changes, or to finish a Renovate protobufs bump that needs call-site work.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An exemplary skill body: dense with non-obvious repo-specific facts, a clear sequenced workflow with explicit validation and error-triage guidance, and appropriate guardrails (never hand-edit generated proto; Renovate boundary; CONTRIBUTING-based PR conventions). The single minor gap is the unspecified exact command for the broad proto-consuming-module compile.

DimensionReasoningScore

Conciseness

Every line carries repo-specific fact Claude could not know: the catalog key location, that models are "not generated in this repo" but come from the Wire-built KMP artifact, snapshot version semantics and ordering, the Renovate boundary, and the exact failure signatures ("NoSuchFieldError/NoSuchMethodError"). There is no padding or explanation of concepts Claude already knows; the one concrete version number ("2.7.26-678281c-SNAPSHOT") appears inline solely as a 'never pin' deprecated-pattern guard, which is load-bearing rather than stale.

5 / 5

Actionability

Mostly executable: set `meshtastic-protobufs = "<version>"`, `git describe --tags --long`, named gradle tasks (`kmpSmokeCompile`, `test`, `allTests`), a named dispatch target (gradle-runner subagent), and `./gradlew :schema-strings:sync`. Kept below 5 only because the 'broad compile of proto-consuming modules (`core:*`, `feature:*`)' names the module pattern but not the exact gradle command line to run for it.

4 / 5

Workflow Clarity

Clear 5-step sequence (read pin, set version, verify, audit, PR) with an explicit validation section ("don't skip test/allTests"), the reason runtime-classpath mismatches surface only in tests, and a feedback loop: "Triage each compile/test failure: adapt this repo's call sites, or, if a break is unexpected, stop and report rather than papering over it." Audit verification is also explicit: "Verify each reference directly: automated gap-lists for this repo are often wrong."

5 / 5

Progressive Disclosure

The body is under 50 lines, needs no external reference files (none exist in the bundle — no references/, scripts/, or assets/ directories), and is cleanly organized into scannable sections (two version forms table, Steps, Verification, Audit, PR + guardrails). Per the rubric's simple-skill guidance, well-organized sections with no external-reference need merit a 5.

5 / 5

Total

19

/

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: concrete, third-person actions covering the full bump workflow, both supported version forms, and an explicit 'Use when' clause naming the two real trigger scenarios. The only gap is a few natural synonym phrasings a user might use instead of 'bump'.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions — "Change the org.meshtastic:protobufs pin", "Verifies with test/allTests (not compile alone) via the gradle-runner subagent", "audits the new field surface, and opens a PR" — plus both concrete version forms (tagged release and X.Y.Z.N-g<sha>-SNAPSHOT). Coverage is comprehensive across the whole bump workflow, matching the score-5 anchor rather than the score-4 anchor's 'minor gaps'.

5 / 5

Completeness

Explicitly answers both questions: the 'what' (change the pin to a tagged release or commit snapshot, verify with test/allTests, audit, open a PR) and the 'when' ("Use to consume new proto changes, or to finish a Renovate protobufs bump that needs call-site work"). The explicit 'Use to...' clause with concrete triggers matches the score-5 anchor; score 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Good natural trigger phrases — "consume new proto changes", "finish a Renovate protobufs bump that needs call-site work", "protobufs" — which are exactly what a user of this repo would say. Not 5 because common variations like "update/upgrade the protobufs version" are missing; not 3 because the natural phrases for this task are present and specific.

4 / 5

Distinctiveness Conflict Risk

Pinned to a single repo (Meshtastic-Android), a single Maven artifact (org.meshtastic:protobufs), and a single operation (the version pin in gradle/libs.versions.toml), with a Renovate boundary note. This is a clear niche with distinct triggers and minimal conflict risk with any other skill.

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.

Repository

meshtastic/Meshtastic-Android

Path

.claude/skills/proto-bump/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.