CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

66

Quality

60%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

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

Quality

Discovery

50%

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 starts reasonably well by naming the specific files (plugin.json, marketplace catalog) and repository context, and includes a few natural trigger terms. However, it is significantly weakened by the boilerplate filler sentences ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') which provide zero useful information and waste space that could contain actual trigger guidance. The word 'Execute' at the beginning is also confusing and appears to be a leftover artifact.

Suggestions

Replace the boilerplate 'Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.' with a concrete 'Use when...' clause, e.g., 'Use when the user asks to bump a version, prepare a release, or update plugin version numbers.'

Add more natural trigger term variations such as 'semver', 'patch bump', 'minor bump', 'major bump', 'new release', 'increment version'.

Remove the leading word 'Execute' which is confusing, and list more specific actions like 'updates version strings in plugin.json, syncs version in marketplace catalog, validates version consistency across files'.

DimensionReasoningScore

Specificity

Names the domain (semantic versioning in plugin.json and marketplace catalog) and the core action (handles version updates), but doesn't list multiple concrete actions beyond that. The phrase 'ensures version consistency' adds some specificity but is still somewhat vague.

2 / 3

Completeness

The 'what' is reasonably covered (semantic version updates across plugin.json and marketplace catalog). However, the 'when' clause is essentially empty boilerplate — 'Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.' provides no actionable guidance for when to select this skill.

2 / 3

Trigger Term Quality

Includes some natural trigger terms like 'version bump', 'update version', and 'release', but the latter half ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') is meaningless filler that adds no real trigger terms. Missing variations like 'semver', 'patch/minor/major bump', 'new version', or 'changelog'.

2 / 3

Distinctiveness Conflict Risk

The mention of 'AI assistant-code-plugins repository', 'plugin.json', and 'marketplace catalog' provides some distinctiveness, but the generic trailing sentences dilute the specificity. It's somewhat distinguishable but could overlap with general versioning or release management skills.

2 / 3

Total

8

/

12

Passed

Implementation

70%

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

This is a well-structured skill with excellent workflow clarity and progressive disclosure. Its main weakness is actionability—the instructions describe what to do in prose but lack complete, executable shell commands or script blocks that Claude could directly execute. The content is reasonably concise but could be tightened by removing some narrative explanation in the examples section.

Suggestions

Add executable shell command blocks for the core operations (e.g., full jq commands for reading/writing versions, the exact pnpm command sequence) instead of describing them in prose.

Replace narrative example descriptions with concrete input/output showing actual shell commands and their expected results.

DimensionReasoningScore

Conciseness

The content is mostly efficient but includes some unnecessary explanation. The prerequisites section explaining what jq is and the error handling table, while useful, add bulk. The overview restates what the instructions already convey. The examples section describes processes narratively rather than showing concrete commands, adding verbosity without proportional value.

2 / 3

Actionability

The instructions describe a clear sequence of actions but lack executable code snippets. Steps reference jq commands in prose (e.g., 'using jq -r .version') but don't provide complete, copy-paste-ready shell commands or scripts for the full bump process. The examples describe processes narratively rather than showing actual commands.

2 / 3

Workflow Clarity

The 8-step workflow is clearly sequenced with an explicit validation checkpoint at step 7 (verify version consistency across all three files). The error handling table provides a feedback loop for common failure modes. The process flows logically from read → compute → update → sync → verify → tag.

3 / 3

Progressive Disclosure

The skill provides a clear overview with well-signaled one-level-deep references to detailed materials (version-bump-process.md, update-locations.md, release-workflow.md, examples.md). The main SKILL.md serves as an effective overview without inlining excessive detail, and all references use consistent ${CLAUDE_SKILL_DIR} paths.

3 / 3

Total

10

/

12

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.