Can I use this in my GitHub Actions?

Yes, the skill is designed to work both locally and within CI environments using the generated prompt and the codex-action.

What is the main purpose of this skill?

It uses LLM judgment to ensure that changeset files correctly reflect the actual code changes and follow the repository's semantic versioning rules.

What output does the validation provide?

It generates a structured JSON response containing a status (ok/errors/warnings) and the required bump level (patch/minor/major/none).

Does it support major version bumps?

Major bumps are only permitted after the first major release; before then, it restricts feature-level changes to minor or patch levels.

How does it handle experimental features?

Experimental or preview-only feature additions explicitly labeled in the diff remain patch bumps if they do not change existing behavior.

Automated Changeset Validation

Name: Automated Changeset Validation
Author: openai

byopenai

•

2,201

•

Deployment & DevOps

Validates version changesets against code diffs using LLM judgment to ensure accurate semantic versioning and repository compliance.

Automated Changeset Validation is a specialized skill designed to streamline the release process by ensuring that changeset files accurately reflect the scope of code changes. By analyzing git diffs—including uncommitted local changes—against a shared set of validation rules, it provides a consistent verdict on whether a version bump should be a patch, minor, or major. This skill is particularly useful for maintaining repository integrity, as it enforces specific logic like restricting major bumps before a 1.0 release and correctly categorizing experimental features. It functions as a single source of truth for both local developer environments and CI/CD pipelines, reducing manual review overhead and preventing versioning errors.

Key Features

01Structured JSON reporting for easy debugging and automation

02LLM-powered validation of git diffs against changeset files

03Automatic detection of appropriate bump levels (patch, minor, major)

04Consistent enforcement of semantic versioning rules across local and CI environments

05Integration with GitHub Actions for automated PR reviews

062,201 GitHub stars

Use Cases

01Automating release notes validation during the continuous integration process

02Preventing accidental major version bumps before a project's 1.0 release

03Verifying that a PR includes the correct changeset for modified packages

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openai/openai-agents-js changeset-validation

For use in Claude.ai and ChatGPT

Download Skill