CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

version-bumper

Execute automatically handles semantic version updates across plugin.json and marketplace catalog when user mentions version bump, update version, or release. ensures version consistency in AI assistant-code-plugins repository. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/examples/jeremy-plugin-tool/skills/version-bumper/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is a strong, executable workflow: concrete commands, a well-sequenced process with an explicit consistency-validation checkpoint, and disciplined use of one-level-deep references. Remaining gaps are minor — the missing exact edit command for the version fields, small duplication between the Examples/Resources sections and bundle files, and four bundle files that are never linked from the body.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence: prerequisites are terse tool requirements, instructions use exact commands, and there is no explanation of semver or JSON basics. It falls short of 5 only through minor redundancy — the inline reference links are repeated verbatim in the Resources section, and the Examples section partially duplicates references/examples.md.

4 / 5

Actionability

Mostly executable guidance with concrete, runnable commands: `jq -r '.version' .claude-plugin/plugin.json`, `pnpm run sync-marketplace`, `git tag -a "v<new_version>" -m "Release v<new_version>"`, and the `chore: Release v<version>` convention. Not a 5 because steps 4 and 5 say to 'update the version field' without the exact edit command, so the core mutation is not copy-paste ready.

4 / 5

Workflow Clarity

The 8 steps are clearly sequenced with an explicit validation checkpoint (step 7: 'Verify version consistency across all three files by reading each and confirming the version strings match') and the Error Handling table provides feedback loops for each failure mode, including mismatch-after-sync recovery. This satisfies the batch-operation validation requirement that would otherwise cap the score at 3.

5 / 5

Progressive Disclosure

The body is a clear overview with well-signaled, one-level-deep references (version-bump-process.md, update-locations.md, release-workflow.md, examples.md) linked both inline at the relevant step and in a Resources section with descriptions. Not a 5 because the bundle contains four files (ARD.md, PRD.md, errors.md, README.md) that are never referenced from the body, and the inline Error Handling table overlaps the presumably-dedicated errors.md rather than pointing to it.

4 / 5

Total

17

/

20

Passed

Description

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

The description answers both 'what' and 'when' with genuinely useful trigger phrases and a distinct plugin-repository niche, but it is let down by garbled grammar ("Execute automatically handles"), vague filler ("Use when appropriate context detected. Trigger with relevant phrases based on skill purpose"), and incomplete coverage of the skill's actual capabilities. A tightened rewrite naming the full set of actions would raise it substantially.

Suggestions

Rewrite the opening for grammar and specificity, e.g., 'Performs semantic version bumps across .claude-plugin/plugin.json, marketplace.extended.json, and the generated marketplace.json catalog in Claude Code plugin repositories, keeping all three files consistent.'

Delete the filler sentences 'Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.' and keep only the concrete when-clause, optionally expanded with natural synonyms such as 'bump the version', 'increment version', or 'cut a release'.

Broaden trigger and capability coverage to match the body: mention git tagging and the release commit convention so the description reflects what the skill actually does and captures release-workflow requests.

DimensionReasoningScore

Specificity

The description names the domain ("semantic version updates across plugin.json and marketplace catalog") and 1-2 concrete actions (update versions, "ensures version consistency"), but coverage is not comprehensive (no mention of git tagging, changelog, or sync-marketplace), and phrases like "Use when appropriate context detected. Trigger with relevant phrases based on skill purpose" are vague filler. It is above score 2 because it does more than minimally name the domain, but below score 4 because the gaps exceed 'minor' and the garbled phrasing ("Execute automatically handles") blurs the concrete actions.

3 / 5

Completeness

Both parts are present: the what ("handles semantic version updates across plugin.json and marketplace catalog", "ensures version consistency") and an explicit when with concrete trigger phrases ("when user mentions version bump, update version, or release"). Not a 5 because the 'what' is awkwardly phrased and diluted by the filler sentence "Use when appropriate context detected", which weakens clarity without adding information.

4 / 5

Trigger Term Quality

"version bump, update version, or release" are three natural phrases a user would plausibly say when needing this skill, giving good keyword coverage analogous to the level-4 example. It falls short of 5 because common synonyms and variations are missing (e.g., "bump the version", "increment version", "cut a release", "new release").

4 / 5

Distinctiveness Conflict Risk

The plugin-specific artifacts ("plugin.json and marketplace catalog", "AI assistant-code-plugins repository") carve a clear niche that most skills would not conflict with. Minor overlap risk remains from the generic term "release", which could also match general release-management, changelog, or git-tagging skills, keeping it below a 5.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/examples/jeremy-plugin-tool/skills/version-bumper/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.