CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-bump

Use this skill to finalize a release. It stamps the [Unreleased] changelog section with a version and date, runs bumpversion to update all version files, and creates the release commit and tag. Only run this when you're ready to ship.

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

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.

A tight, fully executable release procedure with explicit pre- and post-validation, a verification checklist, and error recovery including undo instructions. The only weakness is minor over-explanation of standard semver bump arithmetic.

DimensionReasoningScore

Conciseness

The workflow is lean and command-first with no padding or concept explanations, but the 'Version Calculation Reference' section spells out standard semver arithmetic ("patch -> X.Y.(Z+1)") that Claude already knows — a minor instance of over-explanation that could be trimmed, so it fits the 'efficient; minor instances of over-explanation' anchor rather than 'every token earns its place'.

4 / 5

Actionability

Every step carries a copy-paste-ready command ("git status --porcelain", "bumpversion --allow-dirty <patch|minor|major>", "git tag --list \"v*\" --sort=-v:refname | head -n 5") and the changelog stamping step provides exact markdown templates including the real compare-URL format — fully executable with the common cases (patch/minor/major) covered.

5 / 5

Workflow Clarity

Seven clearly sequenced steps with explicit validation checkpoints (clean-tree pre-check in step 1 with a stop-and-ask gate, post-run file/tag checklist in step 6), a feedback loop ("If bumpversion fails, the tag won't exist. Fix the issue and re-run"), and undo commands in Error Recovery — this matches the validation + checklist + recovery anchor, not the 'minor validation gaps' anchor below.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed: the single linear procedure is appropriately kept inline, sections are clearly headed (Goal, Prerequisites, Workflow, Error Recovery, Notes), and nothing that belongs in a separate file is inlined, so navigation is easy with no organization gaps.

5 / 5

Total

19

/

20

Passed

Description

83%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, third-person description with concrete, tool-specific actions and an explicit timing trigger. Keyword coverage is good but misses a few natural synonyms, and the when-clause is a timing condition rather than concrete trigger phrases.

DimensionReasoningScore

Specificity

It lists four concrete, tool-specific actions — "stamps the [Unreleased] changelog section with a version and date", "runs bumpversion to update all version files", "creates the release commit and tag" — comprehensively covering the skill's scope, matching the comprehensive-coverage anchor rather than the minor-gaps anchor below.

5 / 5

Completeness

Both parts are present: a clear 'what' (three concrete stamped/bump/commit actions) and an explicit 'when' ("Only run this when you're ready to ship"). It scores 4 rather than 5 because the when-clause is a timing condition rather than concrete trigger phrases like 'when the user asks to bump the version or cut a release'.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ("finalize a release", "ready to ship", "changelog", "commit and tag"), but a few common synonyms like "cut a release", "publish", or "bump the version" are missing — matching 'good keyword coverage; a few natural terms missing' rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — release finalization with named tooling (bumpversion, changelog stamping, commit/tag) — and the 'Only run this when you're ready to ship' clause separates it from release-notes drafting or publishing skills, giving minimal conflict risk.

5 / 5

Total

18

/

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

jamiepine/voicebox

Path

.agents/skills/release-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.