// Validate changesets in openai-agents-js using LLM judgment against git diffs (including uncommitted local changes). Use when packages/ or .changeset/ are modified, or when verifying PR changeset compliance and bump level.
| name | changeset-validation |
| description | Validate changesets in openai-agents-js using LLM judgment against git diffs (including uncommitted local changes). Use when packages/ or .changeset/ are modified, or when verifying PR changeset compliance and bump level. |
This skill validates whether changesets correctly reflect package changes and follow the repository rules. It relies on the shared prompt in references/validation-prompt.md so local Codex reviews and GitHub Actions share the same logic.
Experimental or preview-only feature additions that are explicitly labeled as such in the diff may remain a patch bump when they do not change existing behavior.
Major bumps are only allowed after the first major release; before that, do not use major bumps for feature-level changes.
Local (Codex-driven):
pnpm changeset:validate-prompt
references/validation-prompt.md to the generated prompt.CI (Codex Action):
pnpm changeset:validate-prompt -- --ci --output .github/codex/prompts/changeset-validation.generated.md
openai/codex-action with the generated prompt and JSON schema to get a structured verdict.pnpm changeset:validate-prompt.references/validation-prompt.md to judge correctness..changeset/*.md file is already present in the current branch diff, treat it as the active changeset. Do not add a new changeset file.main. Do not try to capture every incremental update.references/validation-prompt.mdDecide how to implement runtime and API changes in openai-agents-js before editing code. Use when a task changes exported APIs, runtime behavior, schemas, tests, or docs and you need to choose the compatibility boundary, whether shims or migrations are warranted, and when unreleased interfaces can be rewritten directly.
Run examples:start-all in auto mode with parallel execution, per-script logs, and start/stop helpers.
Run the integration-tests pipeline that depends on a local npm registry (Verdaccio). Use when asked to execute integration tests or local publish workflows in this repo.
Use when fixing invoice total calculations in the sandbox quickstart repository.
Fix the tiny credit-note formatting bug and rerun the exact targeted test command.
Keep pnpm current: run pnpm self-update/corepack prepare, align packageManager in package.json, and bump pnpm/action-setup + pinned pnpm versions in .github/workflows to the latest release. Use this when refreshing the pnpm toolchain manually or in automation.