Comprehensive version management utilities for semantic versioning automation.
Inherits all available tools
Additional assets for this skill
This skill inherits all available tools. When active, it can use any tool Claude has access to.
examples.mdexamples/bump-scenarios.mdexamples/conventional-commits.mdreference.mdscripts/README.mdscripts/bump-version.shscripts/check-version-sync.shscripts/create-git-tag.shscripts/detect-project-type.shscripts/generate-changelog.shscripts/list-unpushed-commits.shscripts/validate-conventional-commits.shscripts/validate-version.shtemplates/CHANGELOG.mdtemplates/VERSION.jsontemplates/commit-templates.mdtemplates/github-workflows/python-version-management.ymltemplates/github-workflows/typescript-version-management.ymltemplates/python/github-workflows/version-management.ymltemplates/typescript/github-workflows/version-management.ymlComprehensive version management utilities for semantic versioning automation.
This skill provides scripts, templates, and examples for automated version management using semantic versioning and conventional commits. It supports both Python and TypeScript/JavaScript projects with GitHub Actions CI/CD integration.
Functional bash scripts for version management operations:
Production-ready configuration templates:
Realistic examples for common scenarios:
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/detect-project-type.sh <project_dir> <output_file>
Output format (JSON):
{
"project_type": "python|typescript|javascript",
"manifest_file": "pyproject.toml|package.json",
"has_typescript": true|false
}
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/bump-version.sh <bump_type> <current_version>
Bump types: major, minor, patch
Returns: New version string
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/generate-changelog.sh <from_tag> <to_ref> <version>
Outputs formatted changelog to stdout.
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/validate-version.sh <project_dir>
Checks VERSION file, pyproject.toml, package.json for consistency.
Exit codes:
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/create-git-tag.sh <version> <changelog_file>
Creates annotated git tag with changelog as message.
Copy appropriate workflow template:
Python:
cp plugins/versioning/skills/version-manager/templates/github-workflows/python-version-management.yml .github/workflows/version-management.yml
TypeScript:
cp plugins/versioning/skills/version-manager/templates/github-workflows/typescript-version-management.yml .github/workflows/version-management.yml
Copy .releaserc.json template:
cp plugins/versioning/skills/version-manager/templates/releaserc.json .releaserc.json
Customize branches, plugins, and assets as needed.
This skill is used by versioning plugin commands:
This skill provides utilities for versioning plugin agents:
If validation fails with version mismatch:
# Check all version locations
grep -r "version" VERSION pyproject.toml package.json
# Manually sync if needed
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/bump-version.sh patch $(cat VERSION | jq -r '.version')
If changelog is empty or incorrect:
# Verify commit format
git log --oneline --grep="^feat:" --grep="^fix:" -E
# Check tag exists
git tag -l "v*"
# Regenerate manually
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/generate-changelog.sh v1.0.0 HEAD 1.1.0
If tag creation fails:
# Check if tag already exists
git tag -l v1.2.3
# Remove existing tag if needed
git tag -d v1.2.3
# Recreate tag
bash ~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/plugins/versioning/skills/version-manager/scripts/create-git-tag.sh 1.2.3 CHANGELOG.md