phoenix-release-please

v2026.09.24

Bump the next release-please version for a Phoenix Python package (arize-phoenix, arize-phoenix-client, arize-phoenix-evals, arize-phoenix-otel) by opening a PR with a Release-As commit footer. Use this skill when the user asks to "set the release-please version", "force a 2.0.0 release", "release X as Y", "skip a version", or otherwise wants release-please to propose a specific version on its next run instead of the version it would pick from conventional commits.

GitHub
Install command
npx skhub add arize-ai/phoenix-release-please
Markdown
SKILL.md

Phoenix release-please version bump

Force release-please to propose a specific next version for a managed package by landing a commit with a Release-As trailer.

Packages

Declared in release-please-config.json; current versions in .release-please-manifest.json.

PathPackage
.arize-phoenix (root has exclude-paths; touch a file outside them, e.g. src/phoenix/)
packages/phoenix-clientarize-phoenix-client
packages/phoenix-evalsarize-phoenix-evals
packages/phoenix-otelarize-phoenix-otel

Procedure

  1. Verify the bump. jq . .release-please-manifest.json — target must be strictly greater than the current entry.

  2. Branch off main.

  3. Make a small real edit inside the package path (typo fix, comment cleanup). Without a file change in that path, release-please ignores the commit. Don't edit pyproject.toml's version or .release-please-manifest.json — release-please owns those.

  4. Commit with the trailer in the body:

    git commit -m "$(cat <<'EOF'
    chore: release <package> <version>
    
    <one-line rationale>
    
    Release-As: <version>
    EOF
    )"
    
  5. Open the PR with chore: title and the trailer also at the end of the PR body (defensive, in case squash settings change).

Squash-merge gotcha

Repo settings (verify with gh api repos/Arize-ai/phoenix --jq '{squash_merge_commit_title, squash_merge_commit_message}'): COMMIT_OR_PR_TITLE + COMMIT_MESSAGES. The squash body comes from commit messages, not the PR description — so Release-As must live in a real commit's body. A trailer that exists only in the PR description is dropped on squash and release-please never sees it.

Bumping arize-phoenix (root)

The root package's entry in release-please-config.json lists many exclude-paths (.github, docs, js, packages, tests, tutorials, …). A change inside any of those paths is not counted as a server change. Pick a file under src/phoenix/ (or another non-excluded path) for the path-touching edit.

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

NOASSERTION

Source path

.agents/skills/phoenix-release-please

Default branch

main

Latest commit

d7e5aeb

Tree SHA

db9821d