bump-skill-version

Original：🇺🇸 English

Translated

1 scripts

Bump the semver version in a skill's SKILL.md frontmatter following the patch/minor/major rules in CLAUDE.md. Use after modifying a skill's logic or docs.

4installs

Sourcebaphomet480/claude-skills

Added on2026-05-14

NPX Install

npx skill4agent add baphomet480/claude-skills bump-skill-version

SKILL.md Content

View Translation Comparison →

bump-skill-version

Updates the

version:

field in

skills/<name>/SKILL.md

per the rules in CLAUDE.md → Versioning:

patch — bug fixes, typo corrections, doc clarifications
minor — new features, new commands, new sections
major — breaking changes to script CLI, manifest format, or skill structure

Usage

bash

bash "$CLAUDE_PROJECT_DIR/.claude/skills/bump-skill-version/scripts/bump.sh" <skill-name> <patch|minor|major>

Reports the old and new version. Refuses to run if the working tree has uncommitted changes to the target SKILL.md (so the bump becomes its own atomic edit) — pass

--force

to override.

When to use

After editing any file inside
```
skills/<skill-name>/
```
other than trivial whitespace.
Before committing changes that the agent (or a human reviewer) will publish.

Notes

Reads and rewrites the YAML frontmatter in place; preserves all other fields.
The
```
package-skill.sh
```
PostToolUse hook will rebuild
```
dist/<skill-name>.skill
```
automatically once the SKILL.md is edited.

bump-skill-version

NPX Install

Tags

SKILL.md Content

bump-skill-version

Usage

When to use

Notes