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.
Install with Tessl CLI
npx tessl i github:jeremylongshore/claude-code-plugins-plus-skills --skill version-bumper45
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
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 identifies a clear domain (semantic versioning for a specific repository) and includes some trigger terms, but suffers from placeholder language ('Use when appropriate context detected', 'Trigger with relevant phrases') that provides no actionable guidance. The specificity of actions is moderate, and the 'when' clause fails to give Claude meaningful selection criteria.
Suggestions
Replace the vague 'Use when appropriate context detected' with explicit triggers like 'Use when user asks to bump version, prepare a release, update plugin.json version, or sync marketplace catalog versions'
Add more specific actions such as 'increments major/minor/patch versions, updates plugin.json and marketplace catalog in sync, validates version consistency'
Remove the meaningless phrase 'Trigger with relevant phrases based on skill purpose' and instead list concrete variations users might say like 'bump to v2.0', 'release new version', 'update semver'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (semantic version updates) and specific files (plugin.json, marketplace catalog), but the actions are limited to 'handles version updates' without detailing concrete steps like 'increment major/minor/patch', 'sync versions', or 'validate consistency'. | 2 / 3 |
Completeness | The 'what' is partially addressed (version updates across specific files), but the 'when' clause is weak - 'Use when appropriate context detected' and 'Trigger with relevant phrases based on skill purpose' are meaningless placeholders rather than explicit guidance. | 2 / 3 |
Trigger Term Quality | Includes some natural keywords ('version bump', 'update version', 'release') but the phrase 'Trigger with relevant phrases based on skill purpose' is vague filler that adds no value. Missing variations like 'bump version', 'new release', 'semver', or version number patterns. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of specific files (plugin.json, marketplace catalog) and repository (AI assistant-code-plugins) provides some distinctiveness, but generic terms like 'release' and 'update version' could overlap with other versioning or release management skills. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a generic template with placeholder content that provides no actual guidance on version bumping. Despite the description promising semantic version updates across specific files, the body contains no concrete instructions, code examples, or version-specific workflows. The Output section hints at what should happen but the Instructions section fails to explain how.
Suggestions
Add concrete code or commands showing how to read current version from plugin.json, compute the new semantic version, and update the files
Include a specific workflow with validation steps: read version → compute bump → update plugin.json → update marketplace.extended.json → regenerate marketplace.json → validate
Provide at least one concrete example showing input (e.g., 'bump minor version') and expected file changes with before/after JSON snippets
Replace generic instructions like 'Provide necessary context' with specific parameters needed (e.g., bump type: major/minor/patch, plugin path)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is relatively brief but filled with generic placeholder text that adds no value. Phrases like 'automated assistance for the described functionality' and 'Invoke this skill when the trigger conditions are met' are vague filler rather than actionable content. | 2 / 3 |
Actionability | The instructions are entirely abstract with no concrete code, commands, or specific examples. 'Provide necessary context and parameters' and 'Apply modifications as needed' give Claude no executable guidance on how to actually bump versions. | 1 / 3 |
Workflow Clarity | The 4-step workflow is generic boilerplate that could apply to any skill. There are no specific steps for version bumping, no validation checkpoints, and no guidance on how to update plugin.json or marketplace files. | 1 / 3 |
Progressive Disclosure | References to external files (errors.md, examples.md) are present and one-level deep, but the main content is so sparse that there's nothing meaningful to disclose progressively. The structure exists but the content doesn't justify it. | 2 / 3 |
Total | 6 / 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.
Validation — 13 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
metadata_version | 'metadata' field is not a dictionary | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 13 / 16 Passed | |
- 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.