final-release-review Skill

Source

• Creator: openai
• Repository: openai/openai-agents-python
• Skill file: .agents/skills/final-release-review/SKILL.md

What it does

Perform a release-readiness review by locating the previous release tag from remote tags and auditing the diff (e.g., v1.2.3...<commit) for breaking changes, regressions, improvement opportunities, and risks before releasing openai-agents-python.

Skill instructions

Final Release Review Purpose Use this skill when validating the latest release candidate commit (default tip of origin/main) for release. It guides you to fetch remote tags, pick the previous release tag, and thoroughly inspect the BASETAG...TARGET diff for breaking changes, introduced bugs/regressions, improvement opportunities, and release risks. The review must be stable and actionable: avoid variance between runs by using explicit gate rules, and never produce a BLOCKED call without concrete evidence and clear unblock actions. Quick start 1. Ensure repository root: pwd → path-to-workspace/openai-agents-python. 2. Sync tags and pick base (default v): bash BASETAG="$(.agents/skills/final-release-review/scripts/findlatestreleasetag.sh origin 'v')" 3. Choose target commit (default tip of origin/main, ensure fresh): git fetch origin main --prune then TARGET="$(git rev-parse origin/main)". 4. Snapshot scope: bash git diff --stat "${BASETAG}"..."${TARGET}" git diff --dirstat=files,0 "${BA