semver-release-recommender-skill
v2.0.1
Published
Codex skill for analyzing release changes and recommending a semantic version bump.
Maintainers
Readme
Semver Release Recommender Skill
An open-agent skill for analyzing all material changes since the last release and recommending a Semantic Versioning bump.
This repository provides:
- a reusable
semver-release-recommenderskill (skills/semver-release-recommender/SKILL.md) - a portable helper script for release-range evidence collection
- OpenAI-compatible display metadata in
skills/semver-release-recommender/agents/openai.yaml - package metadata for local validation and installation through
npx skills
What This Skill Does
The skill guides Codex to identify the latest SemVer release tag, inspect commits and diffs through the current revision, classify compatibility impact, and produce a defensible patch, minor, or major recommendation. It explicitly treats real public-surface diffs as stronger evidence than commit labels.
Repository Layout
skills/
semver-release-recommender/
SKILL.md
LICENSE.txt
agents/
openai.yaml
assets/
semver-release-recommender-small.svg
semver-release-recommender.svg
references/
evidence-collection.md
release-impact.md
scripts/
analyze_release_semver.py
README.md
CONTRIBUTING.md
SECURITY.md
CHANGELOG.mdInstallation
Install from a local checkout:
npx skills add . -g --agent universal -yInstall from GitHub after publishing the repository:
npx skills add Nick2bad4u/semver-release-recommender -g --agent universal -yValidation
python "C:\Users\Nick\.codex\skills\.system\skill-creator\scripts\quick_validate.py" .\skills\semver-release-recommender
npm run release:verify