About bump-skill-version
bump-skill-version is a script for updating the `version:` field in skill manifests according to the versioning rules in CLAUDE.md. It separates version bumps into their own edit and can rebuild the packaged skill through a hook.
Key features
- 01Classifies changes as patch, minor, or major
- 02Updates YAML frontmatter in place
- 03Preserves other frontmatter fields
- 04Blocks on uncommitted target-file changes
- 05Supports a force override
Use cases
- 01Bump a skill version before publishing
- 02Record documentation fixes as patch updates
- 03Version new features or breaking changes
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/bump-skill-versionin Claude Code to confirm it loaded.
Bundled filesscripts/bump.sh
Details
From the project READMEbump-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 "$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.shPostToolUse hook will rebuilddist/<skill-name>.skillautomatically once the SKILL.md is edited.
Comments
Markdown supported