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

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%Weight 40%Scale 1-3

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

The SKILL.md body is a well-structured, lean overview with concrete commands, a sequenced workflow that includes validation, and properly signaled one-level-deep references to real bundle files.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence: it never explains semver or what a plugin catalog is, and every section (Prerequisites, Instructions, Output, Error Handling, Examples) carries concrete, non-redundant information.	3 / 3
Actionability	Steps give executable commands with exact paths and flags (jq -r '.version', pnpm run sync-marketplace, git tag -a "v<new_version>" -m "..."), making the guidance copy-paste ready.	3 / 3
Workflow Clarity	An 8-step numbered sequence includes an explicit verification checkpoint (step 7: confirm version strings match) and an Error Handling table that supplies fix-and-retry feedback loops for a multi-file batch operation.	3 / 3
Progressive Disclosure	The body is an overview that clearly signals one-level-deep references (version-bump-process.md, update-locations.md, release-workflow.md, examples.md), all of which exist in references/ and are catalogued in a Resources section for easy navigation.	3 / 3
	Total	12 / 12 Passed

Description

90%Weight 40%Scale 1-3

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 is well-targeted with natural trigger terms and an explicit when clause, though it is slightly padded with generic filler ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') and could name its concrete actions more comprehensively.

Suggestions

Remove the generic filler 'Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.' since the explicit trigger clause already covers when-to-use.

Expand the action list from the single 'handles semantic version updates' to multiple concrete operations (e.g., 'bumps versions in plugin.json and marketplace.extended.json, regenerates the catalog, verifies consistency') to reach full specificity.

Dimension	Reasoning	Score
Specificity	Names the domain ('semantic version updates across plugin.json and marketplace catalog') but only loosely enumerates actions; it does not list multiple distinct concrete operations like the score-3 anchor requires.	2 / 3
Completeness	It states what the skill does (semantic version updates across plugin.json and marketplace catalog) and gives explicit trigger guidance ('when user mentions version bump, update version, or release'), satisfying both what and when.	3 / 3
Trigger Term Quality	'version bump, update version, or release' are natural phrases a user would actually say, giving good coverage of common trigger variations.	3 / 3
Distinctiveness Conflict Risk	Scoped to plugin.json and marketplace catalog version bumps in the AI assistant-code-plugins repository, a clear niche with distinct triggers unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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/claude-code-plugins-plus-skills
Path: plugins/examples/jeremy-plugin-tool/skills/version-bumper/SKILL.md
Commit: c4eafaf

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.