Version Bump

SkillCloud & infra

This skill should be used when the user asks to "bump version", "update version", "release patch/minor/major", or mentions semantic versioning. Increments the project version.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Version Bump skill

What this skill tells your AI

The instructions your AI receives, as published by aws-samples/sample-ai-persona in .claude/skills/bump-version/SKILL.md and read by ahel’s review.

Increment the project's semantic version.

Arguments

$ARGUMENTS: major / minor / patch (default: patch)

Single Source of Truth

The version lives only in pyproject.toml (version = "x.y.z"). Everything else reads it at runtime:

  • src/__init__.py__version__ = version("ai-persona-system") (from installed package metadata via importlib.metadata)
  • web/main.py — FastAPI version=__version__, /health returns __version__
  • web/templates/base.html — footer v{{ app_version }} (Jinja global set from __version__)

There are no literal version strings to replace outside pyproject.toml. Do not edit main.py or base.html.

Workflow

  1. Show the current version: uv version

  2. Bump and re-lock in one step (default patch):

    uv version --bump patch    # or: major / minor
    

    This rewrites pyproject.toml and updates uv.lock.

    Do not edit pyproject.toml with Edit/Write — a PreToolUse hook (.claude/hooks/protect-config.sh) blocks writes to protected config files. uv version --bump goes through Bash and is not affected.

  3. Confirm the new version: uv version and git diff pyproject.toml uv.lock

  4. Report changes without committing.

Signals

GitHub stars
24
Forks
6
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
bump-version-aws-samples
Source
github.com/aws-samples/sample-ai-persona